Yama JS

Why Yama?

Yama separates structure from logic:

• Structure lives in YAML (schemas, endpoints, auth rules, behaviors)
• Logic lives in TypeScript handlers
• Platform handles everything else (routing, validation, generation, docs, consistency)

This approach dramatically reduces boilerplate, prevents AI hallucinations, and enables teams to build apps faster and safer.

✨ Features

🚀 Quick Start

Install the Yama CLI globally:

npm install -g @betagors/yama-cli

Create a new project:

yama create my-api
cd my-api
npm install

Start the development server:

yama dev

Your API will be running at http://localhost:4000 🎉

Quick Example

Define your API structure in yama.yaml:

name: my-api
version: 1.0.0
 
schemas:
  Todo:
    type: object
    properties:
      id:
        type: string
        format: uuid
      title:
        type: string
      completed:
        type: boolean
 
endpoints:
  /todos:
    get:
      handler: handlers/listTodos
      response:
        type: array
        items:
          $ref: "#/schemas/Todo"

Write your business logic in TypeScript:

import { HandlerContext } from '@betagors/yama-core';
 
export async function listTodos(context: HandlerContext) {
  return [
    { id: '1', title: 'Learn Yama', completed: false },
    { id: '2', title: 'Build an API', completed: true },
  ];
}

That’s it! Yama handles routing, validation, type generation, and documentation automatically.

📚 Documentation

💡 Philosophy

Yama’s core philosophy:

• YAML defines the contract - Structure is explicit and version-controlled
• Code defines custom behavior - Business logic stays in TypeScript
• Yama guarantees correctness - Type safety, validation, and consistency