@pepshlr/pepdoc 0.0.1

package/dist/core/storage.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * PepsDoc - Storage
+ * Leitura e escrita dos arquivos JSON de documentação
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Storage = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_DIR = 'pepsdoc';
+const CONFIG_FILE = 'pepsdoc.config.json';
+const DATA_DIR = 'data';
+class Storage {
+    constructor(projectRoot) {
+        this.baseDir = path.join(projectRoot, DEFAULT_DIR);
+    }
+    /** Caminho da pasta pepsdoc/ */
+    get dir() {
+        return this.baseDir;
+    }
+    /** Inicializa a estrutura de pastas */
+    init(config) {
+        // Cria pepsdoc/
+        fs.mkdirSync(this.baseDir, { recursive: true });
+        // Cria pepsdoc/data/
+        const dataDir = path.join(this.baseDir, DATA_DIR);
+        fs.mkdirSync(dataDir, { recursive: true });
+        // Cria pepsdoc/pepsdoc.config.json
+        const configPath = path.join(this.baseDir, CONFIG_FILE);
+        if (!fs.existsSync(configPath)) {
+            fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        }
+        // Cria pastas de versão
+        const versions = config.versions?.map((v) => v.name) ?? ['v1'];
+        for (const version of versions) {
+            fs.mkdirSync(path.join(dataDir, version), { recursive: true });
+        }
+    }
+    /** Lê a config */
+    readConfig() {
+        const configPath = path.join(this.baseDir, CONFIG_FILE);
+        if (!fs.existsSync(configPath)) {
+            throw new Error(`Config not found: ${configPath}`);
+        }
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    /** Salva a config */
+    writeConfig(config) {
+        const configPath = path.join(this.baseDir, CONFIG_FILE);
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    /** Lê todos os grupos de uma versão */
+    readGroups(version) {
+        const versionDir = path.join(this.baseDir, DATA_DIR, version);
+        if (!fs.existsSync(versionDir))
+            return [];
+        const files = fs.readdirSync(versionDir).filter((f) => f.endsWith('.json') && f !== 'meta.json');
+        const groups = [];
+        for (const file of files) {
+            const raw = fs.readFileSync(path.join(versionDir, file), 'utf-8');
+            groups.push(JSON.parse(raw));
+        }
+        return groups.sort((a, b) => (a.order ?? 99) - (b.order ?? 99));
+    }
+    /** Salva um grupo de endpoints */
+    writeGroup(version, slug, group) {
+        const versionDir = path.join(this.baseDir, DATA_DIR, version);
+        fs.mkdirSync(versionDir, { recursive: true });
+        const filePath = path.join(versionDir, `${slug}.json`);
+        fs.writeFileSync(filePath, JSON.stringify(group, null, 2), 'utf-8');
+    }
+    /** Lista as versões disponíveis */
+    listVersions() {
+        const dataDir = path.join(this.baseDir, DATA_DIR);
+        if (!fs.existsSync(dataDir))
+            return [];
+        return fs.readdirSync(dataDir).filter((f) => {
+            return fs.statSync(path.join(dataDir, f)).isDirectory();
+        });
+    }
+    /** Compila tudo num objeto só (pro frontend) */
+    compile() {
+        const config = this.readConfig();
+        const versionNames = this.listVersions();
+        const versions = versionNames.map((name) => {
+            const vConfig = config.versions?.find((v) => v.name === name);
+            return {
+                name,
+                badge: vConfig?.badge,
+                badgeColor: vConfig?.badgeColor,
+                groups: this.readGroups(name),
+            };
+        });
+        return { config, versions };
+    }
+    /** Verifica se o pepsdoc já foi inicializado */
+    isInitialized() {
+        return fs.existsSync(path.join(this.baseDir, CONFIG_FILE));
+    }
+}
+exports.Storage = Storage;
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"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"}

package/dist/export/index.d.ts

@@ -0,0 +1,2 @@
+export { endpointToLLM, dataToLLM } from './llm';
+//# sourceMappingURL=index.d.ts.map

package/dist/export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC"}

package/dist/export/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataToLLM = exports.endpointToLLM = void 0;
+var llm_1 = require("./llm");
+Object.defineProperty(exports, "endpointToLLM", { enumerable: true, get: function () { return llm_1.endpointToLLM; } });
+Object.defineProperty(exports, "dataToLLM", { enumerable: true, get: function () { return llm_1.dataToLLM; } });
+//# sourceMappingURL=index.js.map

package/dist/export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":";;;AAAA,6BAAiD;AAAxC,oGAAA,aAAa,OAAA;AAAE,gGAAA,SAAS,OAAA"}

package/dist/export/llm.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PepsDoc - LLM Export
+ * Gera markdown otimizado para IA a partir da documentação
+ */
+import type { PepsDocData, Endpoint } from '../core/schema';
+/** Gera markdown de um endpoint específico (botão "Copy for LLM") */
+export declare function endpointToLLM(endpoint: Endpoint, baseUrl?: string): string;
+/** Gera markdown completo de toda a documentação (export para IA de frontend) */
+export declare function dataToLLM(data: PepsDocData, baseUrl?: string): string;
+//# sourceMappingURL=llm.d.ts.map

package/dist/export/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/export/llm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAE3E,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAkD1E;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BrE"}

package/dist/export/llm.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * PepsDoc - LLM Export
+ * Gera markdown otimizado para IA a partir da documentação
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endpointToLLM = endpointToLLM;
+exports.dataToLLM = dataToLLM;
+/** Gera markdown de um endpoint específico (botão "Copy for LLM") */
+function endpointToLLM(endpoint, baseUrl) {
+    const url = baseUrl ? `${baseUrl}${endpoint.path}` : endpoint.path;
+    let md = `## ${endpoint.method} ${endpoint.path}\n\n`;
+    if (endpoint.summary) {
+        md += `${endpoint.summary}\n\n`;
+    }
+    md += `### Request\n`;
+    md += `- Method: ${endpoint.method}\n`;
+    md += `- URL: ${url}\n`;
+    if (endpoint.headers?.length) {
+        md += `- Headers:\n`;
+        for (const h of endpoint.headers) {
+            md += `  - ${h.name}: ${h.type}${h.required ? ' (required)' : ''}\n`;
+        }
+    }
+    if (endpoint.queryParams?.length) {
+        md += `- Query Parameters:\n`;
+        for (const p of endpoint.queryParams) {
+            md += `  - ${p.name}: ${p.type}${p.required ? ' (required)' : ''}${p.description ? ` — ${p.description}` : ''}\n`;
+        }
+    }
+    if (endpoint.body) {
+        md += `- Content-Type: ${endpoint.body.contentType || 'application/json'}\n`;
+        if (endpoint.body.fields?.length) {
+            md += `- Body fields:\n`;
+            for (const f of endpoint.body.fields) {
+                md += `  - ${f.name}: ${f.type}${f.required ? ' (required)' : ''}${f.description ? ` — ${f.description}` : ''}\n`;
+            }
+        }
+        if (endpoint.body.example) {
+            md += `- Body example:\n\`\`\`json\n${JSON.stringify(endpoint.body.example, null, 2)}\n\`\`\`\n`;
+        }
+    }
+    if (endpoint.responses?.length) {
+        md += `\n### Responses\n`;
+        for (const r of endpoint.responses) {
+            md += `\n#### ${r.status}${r.description ? ` — ${r.description}` : ''}\n`;
+            if (r.example) {
+                md += `\`\`\`json\n${JSON.stringify(r.example, null, 2)}\n\`\`\`\n`;
+            }
+        }
+    }
+    return md;
+}
+/** Gera markdown completo de toda a documentação (export para IA de frontend) */
+function dataToLLM(data, baseUrl) {
+    let md = `# ${data.config.title} — API Reference\n\n`;
+    if (data.config.description) {
+        md += `${data.config.description}\n\n`;
+    }
+    if (baseUrl) {
+        md += `Base URL: \`${baseUrl}\`\n\n`;
+    }
+    md += `---\n\n`;
+    for (const version of data.versions) {
+        md += `## Version: ${version.name}`;
+        if (version.badge)
+            md += ` (${version.badge})`;
+        md += `\n\n`;
+        for (const group of version.groups) {
+            md += `### ${group.group}\n\n`;
+            for (const endpoint of group.endpoints) {
+                md += endpointToLLM(endpoint, baseUrl);
+                md += `\n---\n\n`;
+            }
+        }
+    }
+    return md;
+}
+//# sourceMappingURL=llm.js.map

package/dist/export/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/export/llm.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PepsDoc - API documentation, beautifully automated.
+ *
+ * Usage:
+ * ```ts
+ * import express from 'express';
+ * import { pepsdoc } from 'pepsdoc';
+ *
+ * const app = express();
+ * pepsdoc(app, { title: 'My API' });
+ * app.listen(3000);
+ * // Docs at http://localhost:3000/docs
+ * ```
+ */
+import type { PepsDocConfig } from './core/schema';
+export declare function pepsdoc(app: unknown, config?: Partial<PepsDocConfig>): void;
+export { expressAdapter } from './adapters/express';
+export { Storage } from './core/storage';
+export { DEFAULT_CONFIG, METHOD_COLORS } from './core/config';
+export { endpointToLLM, dataToLLM } from './export/llm';
+export type { PepsDocConfig, VersionConfig, TabConfig, ThemeConfig, HttpMethod, EndpointGroup, Endpoint, ParamField, RequestBody, ResponseDefinition, Note, PepsDocData, VersionData, } from './core/schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAE3E;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGxD,YAAY,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,IAAI,EACJ,WAAW,EACX,WAAW,GACZ,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * PepsDoc - API documentation, beautifully automated.
+ *
+ * Usage:
+ * ```ts
+ * import express from 'express';
+ * import { pepsdoc } from 'pepsdoc';
+ *
+ * const app = express();
+ * pepsdoc(app, { title: 'My API' });
+ * app.listen(3000);
+ * // Docs at http://localhost:3000/docs
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataToLLM = exports.endpointToLLM = exports.METHOD_COLORS = exports.DEFAULT_CONFIG = exports.Storage = exports.expressAdapter = void 0;
+exports.pepsdoc = pepsdoc;
+const express_1 = require("./adapters/express");
+// Main function — alias for Express adapter (default)
+function pepsdoc(app, config) {
+    (0, express_1.expressAdapter)(app, config);
+}
+// Re-export everything
+var express_2 = require("./adapters/express");
+Object.defineProperty(exports, "expressAdapter", { enumerable: true, get: function () { return express_2.expressAdapter; } });
+var storage_1 = require("./core/storage");
+Object.defineProperty(exports, "Storage", { enumerable: true, get: function () { return storage_1.Storage; } });
+var config_1 = require("./core/config");
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_1.DEFAULT_CONFIG; } });
+Object.defineProperty(exports, "METHOD_COLORS", { enumerable: true, get: function () { return config_1.METHOD_COLORS; } });
+var llm_1 = require("./export/llm");
+Object.defineProperty(exports, "endpointToLLM", { enumerable: true, get: function () { return llm_1.endpointToLLM; } });
+Object.defineProperty(exports, "dataToLLM", { enumerable: true, get: function () { return llm_1.dataToLLM; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAMH,0BAEC;AAND,gDAAoD;AAGpD,sDAAsD;AACtD,SAAgB,OAAO,CAAC,GAAY,EAAE,MAA+B;IACnE,IAAA,wBAAc,EAAC,GAA2C,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,uBAAuB;AACvB,8CAAoD;AAA3C,yGAAA,cAAc,OAAA;AACvB,0CAAyC;AAAhC,kGAAA,OAAO,OAAA;AAChB,wCAA8D;AAArD,wGAAA,cAAc,OAAA;AAAE,uGAAA,aAAa,OAAA;AACtC,oCAAwD;AAA/C,oGAAA,aAAa,OAAA;AAAE,gGAAA,SAAS,OAAA"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pepshlr/pepdoc",
+  "version": "0.0.1",
+  "description": "API documentation, beautifully automated.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "pepsdoc": "dist/bin/pepsdoc.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "ui/build"
+  ],
+  "scripts": {
+    "build": "tsc && cd ui && npm run build",
+    "build:core": "tsc",
+    "build:ui": "cd ui && npm run build",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "api",
+    "documentation",
+    "swagger",
+    "openapi",
+    "docs",
+    "rest",
+    "api-docs"
+  ],
+  "author": "Pedroohlr",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Pedroohlr/pepsdoc"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}

package/templates/ai-skill.md

@@ -0,0 +1,203 @@
+# PepsDoc — AI Skill
+
+You are tasked with documenting a backend API using the PepsDoc framework.
+
+## What is PepsDoc?
+
+PepsDoc is a documentation framework that stores API docs as JSON files in a `pepsdoc/` folder. These JSON files are rendered into a beautiful, modern documentation UI.
+
+## How it works
+
+1. The project has a `pepsdoc/` folder with:
+   - `pepsdoc.config.json` — General configuration
+   - `data/<version>/` — Folders for each API version (e.g. `data/v1/`)
+   - Inside each version folder: one `.json` file per endpoint group
+
+2. You need to analyze the backend code and generate the JSON files.
+
+## Step-by-step
+
+### 1. Check if PepsDoc is initialized
+
+Look for a `pepsdoc/pepsdoc.config.json` file. If it doesn't exist, run:
+```bash
+npx pepsdoc init
+```
+
+### 2. Read the config
+
+Read `pepsdoc/pepsdoc.config.json` to understand the project setup (title, versions, etc.).
+
+### 3. Analyze the backend code
+
+Scan the backend source code to find:
+- All API routes/endpoints
+- HTTP methods (GET, POST, PUT, PATCH, DELETE)
+- Route parameters, query parameters
+- Request body schemas
+- Response schemas and status codes
+- Authentication requirements
+- Route groupings (by resource/feature)
+
+### 4. Generate the JSON files
+
+For each group of related endpoints (e.g. "Users", "Products", "Auth"), create a JSON file:
+
+**File:** `pepsdoc/data/v1/<group-slug>.json`
+
+**Schema:**
+```json
+{
+  "group": "Group Name",
+  "icon": "icon-name",
+  "order": 1,
+  "endpoints": [
+    {
+      "method": "GET | POST | PUT | PATCH | DELETE",
+      "path": "/api/v1/resource",
+      "summary": "Short description",
+      "description": "Detailed description of what this endpoint does.",
+      "headers": [
+        {
+          "name": "Authorization",
+          "type": "string",
+          "required": true,
+          "description": "Bearer token"
+        }
+      ],
+      "queryParams": [
+        {
+          "name": "page",
+          "type": "number",
+          "required": false,
+          "description": "Page number",
+          "default": "1"
+        }
+      ],
+      "pathParams": [
+        {
+          "name": "id",
+          "type": "string",
+          "required": true,
+          "description": "Resource ID"
+        }
+      ],
+      "body": {
+        "contentType": "application/json",
+        "fields": [
+          {
+            "name": "name",
+            "type": "string",
+            "required": true,
+            "description": "User name"
+          }
+        ],
+        "example": {
+          "name": "John Doe"
+        }
+      },
+      "responses": [
+        {
+          "status": 200,
+          "description": "Success",
+          "example": {
+            "id": 1,
+            "name": "John Doe"
+          }
+        },
+        {
+          "status": 400,
+          "description": "Bad request",
+          "example": {
+            "error": "Invalid input"
+          }
+        }
+      ],
+      "tags": ["users"],
+      "deprecated": false,
+      "notes": [
+        {
+          "type": "info",
+          "title": "Rate limit",
+          "content": "This endpoint is rate limited to 100 requests per minute."
+        }
+      ]
+    }
+  ]
+}
+```
+
+### 5. Update the config if needed
+
+If you identify multiple versions or need tabs, update `pepsdoc/pepsdoc.config.json`:
+
+```json
+{
+  "title": "My API",
+  "description": "Complete API documentation",
+  "basePath": "/docs",
+  "versions": [
+    {
+      "name": "v1",
+      "badge": "stable",
+      "badgeColor": "green",
+      "default": true
+    }
+  ],
+  "tabs": [
+    { "name": "REST API", "slug": "rest" },
+    { "name": "Webhooks", "slug": "webhooks" }
+  ]
+}
+```
+
+## Integration with backend
+
+If the backend uses **Node.js** (Express, Fastify, etc.), add PepsDoc to serve the docs:
+
+```typescript
+import express from 'express';
+import { pepsdoc } from 'pepsdoc';
+
+const app = express();
+
+pepsdoc(app, {
+  title: 'My API',
+  version: '1.0.0',
+});
+
+app.listen(3000);
+// Docs available at http://localhost:3000/docs
+```
+
+For **non-Node.js backends** (Python, Go, Java, etc.):
+- Just generate the JSON files in `pepsdoc/data/`
+- Run `npx pepsdoc build` to generate a static build
+- Serve the `pepsdoc/.build/` folder as static files from your backend
+
+## Important rules
+
+- One JSON file per endpoint group (e.g. `users.json`, `products.json`)
+- Use kebab-case for file names (e.g. `user-settings.json`)
+- Always include realistic examples in request body and responses
+- Group related endpoints together logically
+- Set the `order` field to control sidebar ordering (lower = higher)
+- Mark deprecated endpoints with `"deprecated": true`
+- Use `notes` to add important information (rate limits, auth requirements, etc.)
+
+## Supported languages
+
+PepsDoc can document APIs written in ANY language. Just analyze the backend code (routes, controllers, handlers) and generate the JSON files following the schema above.
+
+Common backend patterns to look for:
+- **Express.js**: `app.get()`, `router.post()`, etc.
+- **Fastify**: `fastify.get()`, route schemas
+- **NestJS**: `@Get()`, `@Post()` decorators
+- **Django/DRF**: `urlpatterns`, `ViewSet`, `@api_view`
+- **Flask**: `@app.route()`, `@blueprint.route()`
+- **FastAPI**: `@app.get()`, Pydantic models
+- **Spring Boot**: `@GetMapping`, `@PostMapping`
+- **Gin (Go)**: `r.GET()`, `r.POST()`
+- **Actix/Axum (Rust)**: route definitions, handler functions
+- **Laravel**: `Route::get()`, controllers
+- **Rails**: `resources`, `get`, `post` in routes.rb