ebade 0.1.0 → 0.2.1

package/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [hasankemaldemirci]
+# custom: ["https://www.buymeacoffee.com/hasankemal", "https://patreon.com/ebade"]

package/README.md

@@ -1,11 +1,16 @@
 # ebade 🧠
 
+![ebade - The First Agent-First Framework](https://ebade.dev/og-readme.png)
+
+[![npm version](https://img.shields.io/npm/v/ebade.svg)](https://www.npmjs.com/package/ebade)
+[![Website](https://img.shields.io/badge/Website-ebade.dev-4F46E5)](https://ebade.dev)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![MCP Server](https://img.shields.io/badge/MCP-Ready-green.svg)](./packages/mcp-server)
 [![Status](https://img.shields.io/badge/Status-Alpha-orange.svg)](./ROADMAP.md)
-[![Green AI](https://img.shields.io/badge/🌱_Green_AI-66%25_Less_Tokens-brightgreen)](./docs/GREEN-AI.md)
+[![Green AI](https://img.shields.io/badge/🌱_Green_AI-70%25_Less_Tokens-brightgreen)](./docs/GREEN-AI.md)
+[![Sponsor](https://img.shields.io/badge/Sponsor-ebade-pink.svg?logo=github-sponsors)](https://github.com/sponsors/hasankemaldemirci)
 
-> **The first framework designed FOR AI agents, readable by humans.**
+> **The first framework designed for AI agents, readable by humans.**
 >
 > `Code = f(ebade)`
 >
@@ -72,16 +77,17 @@ npx ebade dev
 
 ---
 
-## 📊 Benchmark: ~66% Fewer Tokens (Tested)
+## 📊 Benchmark: ~70% Fewer Tokens (Tested)
 
 We measured token usage across common development tasks:
 
 | Task | Next.js | ebade | Savings | Efficiency |
-|------|---------|-------|---------|------------|
+| :--- | :--- | :--- | :--- | :--- |
 | Checkout Page | 258 tokens | 66 tokens | **74.4%** | 3.9x |
 | Product Listing | 133 tokens | 63 tokens | **52.6%** | 2.1x |
 | User Auth | 148 tokens | 56 tokens | **62.2%** | 2.6x |
-| **Average** | | | **65.7%** | **2.9x** |
+| SaaS Dashboard ⭐ | 1,850 tokens | 245 tokens | **86.8%** | 7.6x |
+| **Average** | | | **68.8%** | **4.1x** |
 
 > *For full project scaffolding, savings can reach 75-92%.*
 
@@ -90,7 +96,7 @@ We measured token usage across common development tasks:
 At scale (1M AI coding sessions):
 
 | Framework | Token Cost | Savings |
-|-----------|------------|---------|
+| :--- | :--- | :--- |
 | Next.js | $5,390 | - |
 | **ebade** | **$1,850** | **$3,540** |
 
@@ -104,8 +110,9 @@ At scale (1M AI coding sessions):
 
 AI agents (Cursor, Copilot, Claude) write code for **human-designed frameworks**:
 
-```
+```text
 AI: "Is this a server or client component?"
+
 AI: "App router or pages router?"
 AI: "useState or useReducer?"
 AI: "Where does this file go?"
@@ -117,7 +124,7 @@ Every decision is **ambiguous**. AI guesses. Sometimes wrong.
 
 **ebade** - A framework where AI expresses **intent**, not implementation.
 
-```
+```text
 Human describes → AI writes intent → ebade compiles → Working code
                         ↑
                  No ambiguity here
@@ -128,11 +135,11 @@ Human describes → AI writes intent → ebade compiles → Working code
 ## 📦 Packages
 
 | Package | Description | Status |
-|---------|-------------|--------|
+| :--- | :--- | :--- |
+| **`ebade`** | Core Framework & CLI | ✅ Alpha |
 | [@ebade/mcp-server](./packages/mcp-server) | MCP Server for AI agents | ✅ Alpha |
-| @ebade/cli | Command-line interface | 🚧 Coming |
-| @ebade/compiler | Intent → Code compiler | 🚧 Coming |
-| @ebade/vscode | VS Code extension | 📋 Planned |
+| `@ebade/compiler` | Advanced Intent Compiler | 🚧 Planning |
+| `@ebade/vscode` | VS Code extension | 📋 Planned |
 
 ---
 
@@ -215,7 +222,7 @@ pages:
 ## 🎭 The Paradigm Shift
 
 | Era | Paradigm | Core Question |
-|-----|----------|---------------|
+| :--- | :--- | :--- |
 | 2000s | jQuery | "How do I manipulate DOM?" |
 | 2013 | React | "What if UI = f(state)?" |
 | 2024 | AI Coding | "AI writes code, but for humans" |
@@ -247,17 +254,23 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
 ---
 
+## 💎 Support the Movement
+
+**ebade** is an ambitious project aiming to redefine how we build software in the age of AI. Your support helps us move faster, maintain high-quality documentation, and build a more sustainable "Green AI" future.
+
+- **[Become a GitHub Sponsor](https://github.com/sponsors/hasankemaldemirci)** 💖
+- **Star the repo** to show your support ⭐
+- **Share the project** with other AI enthusiasts 🚀
+
+---
+
 ## 📄 License
 
 MIT © ebade Contributors — Made with ❤️ in Türkiye 🇹🇷
 
 ---
 
-<p align="center">
-  <strong>Built for AI. Readable by humans. Revolutionary by design.</strong>
-</p>
+**Built for AI. Readable by humans. Revolutionary by design.**
 
-<p align="center">
-  <i>TypeScript made JavaScript better for humans.<br/>
-  ebade makes frameworks better for AI.</i>
-</p>
+*TypeScript made JavaScript better for humans.*
+*ebade makes frameworks better for AI.*

package/ROADMAP.md

@@ -12,9 +12,9 @@ It's more efficient, deterministic, and KIND TO EARTH. 🌱
 
 ---
 
-## Phase 1: Foundation (Week 1-2) ✅ IN PROGRESS
+## Phase 1: Foundation (Week 1-2) ✅ COMPLETE
 
-### 1.1 MCP Server
+### 1.1 MCP Server ✅
 
 Make ebade usable by AI agents RIGHT NOW.
 
@@ -24,7 +24,19 @@ Make ebade usable by AI agents RIGHT NOW.
 - [x] `ebade_compile` tool - compile single ebade to code
 - [x] `ebade_generate` tool - infer ebade from natural language
 
-### 1.2 Real Compiler
+### 1.2 CLI Premium Experience ✅
+
+- [x] ASCII Art logo on startup
+- [x] Spinner animations for progress
+- [x] Statistics summary (files, token savings, time)
+- [x] "Generated via ebade" headers in all output files
+
+### 1.3 Examples & Templates ✅
+
+- [x] E-commerce template (193 lines)
+- [x] SaaS Dashboard template (300 lines, multi-tenant, billing, team management)
+
+### 1.4 Real Compiler (In Progress)
 
 Replace string templates with actual AST-based compilation.
 
@@ -32,7 +44,7 @@ Replace string templates with actual AST-based compilation.
 - [ ] Code generator (AST → React/Next.js)
 - [ ] Support for multiple framework targets
 
-### 1.3 CLI Improvements
+### 1.5 CLI Improvements
 
 - [ ] `ebade init` - interactive project setup
 - [ ] `ebade dev` - watch mode with local agent sync
@@ -71,7 +83,7 @@ Replace string templates with actual AST-based compilation.
 
 ### 3.2 Framework Targets
 
-- [ ] Next.js App Router ✅ (v0.1)
+- [x] Next.js App Router ✅ (v0.1)
 - [ ] Vue 3 + Nuxt
 - [ ] Svelte + SvelteKit
 - [ ] Mobile (React Native / Flutter)
@@ -99,20 +111,20 @@ Replace string templates with actual AST-based compilation.
 
 ## Success Metrics (3 Months)
 
-| Metric | Target | Mission |
-| :--- | :--- | :--- |
-| Token Savings | >70% | Efficiency |
-| Carbon Saved | >100kg | Sustainability |
-| Framework Targets | 3 | Accessibility |
-| Community Size | 1,000 "Badiks" | Impact |
+| Metric | Target | Current | Status |
+| :--- | :--- | :--- | :--- |
+| Token Savings | >70% | ~70% | ✅ |
+| Carbon Saved | >100kg | TBD | 🔄 |
+| Framework Targets | 3 | 1 | 🔄 |
+| Community Size | 1,000 "Badiks" | 0 | 🔜 |
 
 ---
 
 ## Current Status
 
-**Phase 1.1 - MCP Server** ← WE ARE HERE
+**Phase 1 - Foundation** ← NEARLY COMPLETE
 
-The MCP server is live. AI agents can now use ebade to scaffold full Next.js apps with 65% fewer tokens.
+The MCP server is live. CLI has premium UX. Two comprehensive examples (E-commerce + SaaS Dashboard) are ready. AI agents can now use ebade to scaffold full Next.js apps with **~70% fewer tokens**.
 
 ---
 

package/benchmarks/RESULTS.md

@@ -1,6 +1,6 @@
 # ebade Benchmark Results 📊
 
-> **The first framework designed FOR AI agents, readable by humans.**
+> **The first framework designed for AI agents, readable by humans.**
 
 ---
 

package/cli/scaffold.js

@@ -10,6 +10,7 @@
 import fs from "fs";
 import path from "path";
 import yaml from "yaml";
+import ora from "ora";
 
 // ============================================
 // ANSI Renk Kodları (Terminal çıktısı için)
@@ -23,8 +24,22 @@ const colors = {
   yellow: "\x1b[33m",
   cyan: "\x1b[36m",
   magenta: "\x1b[35m",
+  red: "\x1b[31m",
+  gray: "\x1b[90m",
 };
 
+// ASCII Art Logo
+const LOGO = `
+${colors.magenta}    ███████╗${colors.cyan}██████╗  ${colors.magenta}█████╗ ${colors.cyan}██████╗ ${colors.magenta}███████╗
+${colors.magenta}    ██╔════╝${colors.cyan}██╔══██╗${colors.magenta}██╔══██╗${colors.cyan}██╔══██╗${colors.magenta}██╔════╝
+${colors.magenta}    █████╗  ${colors.cyan}██████╔╝${colors.magenta}███████║${colors.cyan}██║  ██║${colors.magenta}█████╗  
+${colors.magenta}    ██╔══╝  ${colors.cyan}██╔══██╗${colors.magenta}██╔══██║${colors.cyan}██║  ██║${colors.magenta}██╔══╝  
+${colors.magenta}    ███████╗${colors.cyan}██████╔╝${colors.magenta}██║  ██║${colors.cyan}██████╔╝${colors.magenta}███████╗
+${colors.magenta}    ╚══════╝${colors.cyan}╚═════╝ ${colors.magenta}╚═╝  ╚═╝${colors.cyan}╚═════╝ ${colors.magenta}╚══════╝${colors.reset}
+    
+    ${colors.dim}✨ Agent-First Framework ${colors.yellow}v0.1.0${colors.reset}
+`;
+
 const log = {
   info: (msg) => console.log(`${colors.blue}ℹ${colors.reset} ${msg}`),
   success: (msg) => console.log(`${colors.green}✓${colors.reset} ${msg}`),
@@ -115,13 +130,16 @@ function generatePage(page, design) {
 
   return `
 /**
+ * 🧠 Generated via ebade - The Agent-First Framework
+ * https://github.com/hasankemaldemirci/ebade
+ * 
  * @page('${page.path}')
- * @ebade('${page.intent}')
- * Built with ebade 
+ * @intent('${page.intent}')
  */
 
 ${componentImports}
 
+
 export default function ${toPascalCase(page.intent)}Page() {
   return (
     <main className="page ${page.intent}">
@@ -141,10 +159,13 @@ function generateApiRoute(endpoint) {
   const handlers = endpoint.methods
     .map(
       (method) => `
+/**
+ * 🧠 Generated via ebade - The Agent-First Framework
+ * ${method} ${endpoint.path}
+ * Auth: ${endpoint.auth || "none"}
+ */
 export async function ${method}(request) {
-  // TODO: Implement ${method} handler for ${endpoint.path}
-  // Auth: ${endpoint.auth || "none"}
-  // Built with ebade
+  // TODO: Implement ${method} handler
   
   return Response.json({ 
     message: "${method} ${endpoint.path} - Not implemented" 
@@ -494,12 +515,10 @@ function ensureDir(dir) {
 // Main Scaffold Function
 // ============================================
 function scaffold(ebadePath, outputDir) {
-  console.log(`
-${colors.bright}${colors.magenta}╔════════════════════════════════════════╗
-命       ebade Scaffold CLI              命
-命   🤖 Agent-First Framework Generator   命
-╚════════════════════════════════════════╝${colors.reset}
-`);
+  const startTime = Date.now();
+  let stats = { pages: 0, components: 0, apiRoutes: 0, files: 0 };
+
+  console.log(LOGO);
 
   // Parse ebade file
   log.info(`Reading ebade file: ${ebadePath}`);
@@ -534,6 +553,7 @@ ${colors.bright}${colors.magenta}╔══════════════
   log.section("Generating pages");
 
   if (config.pages) {
+    const spinner = ora("Generating pages...").start();
     config.pages.forEach((page) => {
       const pagePath =
         page.path === "/"
@@ -545,8 +565,12 @@ ${colors.bright}${colors.magenta}╔══════════════
 
       const pageContent = generatePage(page, config.design);
       fs.writeFileSync(path.join(projectDir, pagePath), pageContent.trim());
-      log.file(`${pagePath} (${page.intent})`);
+      stats.pages++;
+      stats.files++;
     });
+    spinner.succeed(
+      `Generated ${colors.bright}${stats.pages}${colors.reset} pages`
+    );
   }
 
   // ========== Generate Components ==========
@@ -557,6 +581,7 @@ ${colors.bright}${colors.magenta}╔══════════════
     page.components?.forEach((c) => allComponents.add(c));
   });
 
+  const spinner2 = ora("Generating components...").start();
   allComponents.forEach((component) => {
     const componentPath = `components/${component}.tsx`;
     const template = componentTemplates[component];
@@ -569,13 +594,18 @@ ${colors.bright}${colors.magenta}╔══════════════
         )}() {\n  return <div>${component}</div>;\n}\n`;
 
     fs.writeFileSync(path.join(projectDir, componentPath), content.trim());
-    log.file(componentPath);
+    stats.components++;
+    stats.files++;
   });
+  spinner2.succeed(
+    `Generated ${colors.bright}${stats.components}${colors.reset} components`
+  );
 
   // ========== Generate API Routes ==========
   log.section("Generating API routes");
 
   if (config.api) {
+    const spinner3 = ora("Generating API routes...").start();
     config.api.forEach((endpoint) => {
       const apiPath = `app/api${endpoint.path}/route.ts`;
       const apiDir = path.dirname(path.join(projectDir, apiPath));
@@ -583,8 +613,12 @@ ${colors.bright}${colors.magenta}╔══════════════
 
       const routeContent = generateApiRoute(endpoint);
       fs.writeFileSync(path.join(projectDir, apiPath), routeContent.trim());
-      log.file(`${apiPath} [${endpoint.methods.join(", ")}]`);
+      stats.apiRoutes++;
+      stats.files++;
     });
+    spinner3.succeed(
+      `Generated ${colors.bright}${stats.apiRoutes}${colors.reset} API routes`
+    );
   }
 
   // ========== Generate Design System ==========
@@ -651,23 +685,44 @@ ${colors.bright}${colors.magenta}╔══════════════
   log.file("project.ebade.yaml (for agent reference)");
 
   // ========== Summary ==========
-  console.log(`
-${colors.bright}${colors.green}════════════════════════════════════════${colors.reset}
-${colors.green}✓${colors.reset} ebade scaffold complete!
+  const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+  const estimatedTokenSavings = Math.round(stats.files * 35); // ~35 tokens saved per file
 
-${colors.dim}Project:${colors.reset} ${config.name}
-${colors.dim}Type:${colors.reset} ${config.type}
-${colors.dim}Output:${colors.reset} ${projectDir}
+  console.log(`
+${colors.bright}${colors.green}  ┌${"─".repeat(41)}┐${colors.reset}
+${colors.green}  │${colors.reset}  ${colors.bright}✅ ebade scaffold complete!${
+    colors.reset
+  }              ${colors.green}│${colors.reset}
+${colors.green}  ├${"─".repeat(41)}┤${colors.reset}
+${colors.green}  │${colors.reset}  ${colors.dim}Project:${
+    colors.reset
+  } ${config.name.padEnd(26)} ${colors.green}│${colors.reset}
+${colors.green}  │${colors.reset}  ${colors.dim}Type:${
+    colors.reset
+  }    ${config.type.padEnd(26)} ${colors.green}│${colors.reset}
+${colors.green}  ├${"─".repeat(41)}┤${colors.reset}
+${colors.green}  │${colors.reset}  ${colors.cyan}📁 Files Created:${
+    colors.reset
+  }    ${String(stats.files).padEnd(18)} ${colors.green}│${colors.reset}
+${colors.green}  │${colors.reset}  ${colors.cyan}📊 Token Savings:${
+    colors.reset
+  }    ~${String(estimatedTokenSavings).padEnd(17)} ${colors.green}│${
+    colors.reset
+  }
+${colors.green}  │${colors.reset}  ${colors.cyan}⏱  Completed in:${
+    colors.reset
+  }    ${String(duration + "s").padEnd(18)} ${colors.green}│${colors.reset}
+${colors.green}  └${"─".repeat(41)}┘${colors.reset}
 
 ${colors.dim}Next steps:${colors.reset}
-  1. cd ${projectDir}
-  2. npm install
-  3. npm run dev
-
-${colors.yellow}Note:${colors.reset} The generated code is a starting point.
-      An AI Agent can now read project.ebade.yaml
-      to understand and iterate on this project.
-${colors.bright}${colors.green}════════════════════════════════════════${colors.reset}
+  ${colors.gray}1.${colors.reset} cd ${colors.cyan}${projectDir}${colors.reset}
+  ${colors.gray}2.${colors.reset} npm install
+  ${colors.gray}3.${colors.reset} npm run dev
+
+${colors.yellow}💡 Tip:${colors.reset} AI Agents can read ${
+    colors.cyan
+  }project.ebade.yaml${colors.reset}
+       to understand and iterate on this project.
 `);
 }
 
@@ -675,32 +730,63 @@ ${colors.bright}${colors.green}════════════════
 // CLI Entry Point
 // ============================================
 const args = process.argv.slice(2);
+const command = args[0];
 
-if (args.length === 0) {
+function showHelp() {
   console.log(`
-${colors.bright}ebade Scaffold CLI${colors.reset}
+${colors.bright}ebade CLI${colors.reset} - The Agent-First Framework
 
-Usage:
-  npx ebade scaffold <ebade-file> [output-dir]
+${colors.dim}Usage:${colors.reset}
+  npx ebade <command> [options]
 
-Example:
+${colors.dim}Commands:${colors.reset}
+  scaffold <file> [output]   Scaffold a project from ebade file
+  
+${colors.dim}Examples:${colors.reset}
   npx ebade scaffold examples/ecommerce.ebade.yaml ./output
+  npx ebade scaffold my-project.ebade.yaml
 
-Options:
-  ebade-file   Path to .ebade.yaml file
-  output-dir    Output directory (default: ./output)
+${colors.dim}Learn more:${colors.reset}
+  https://ebade.dev
 `);
-  process.exit(1);
 }
 
-const ebadeFile = args[0];
-const outputDir = args[1] || "./output";
+if (
+  args.length === 0 ||
+  command === "help" ||
+  command === "--help" ||
+  command === "-h"
+) {
+  showHelp();
+  process.exit(0);
+}
 
-if (!fs.existsSync(ebadeFile)) {
+if (command === "scaffold") {
+  const ebadeFile = args[1];
+  const outputDir = args[2] || "./output";
+
+  if (!ebadeFile) {
+    console.error(
+      `${colors.red}Error:${colors.reset} Please provide an ebade file path.`
+    );
+    console.log(
+      `\n${colors.dim}Usage:${colors.reset} npx ebade scaffold <file.ebade.yaml> [output-dir]\n`
+    );
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(ebadeFile)) {
+    console.error(
+      `${colors.red}Error:${colors.reset} ebade file not found: ${ebadeFile}`
+    );
+    process.exit(1);
+  }
+
+  scaffold(ebadeFile, outputDir);
+} else {
   console.error(
-    `${colors.red}Error:${colors.reset} ebade file not found: ${ebadeFile}`
+    `${colors.red}Error:${colors.reset} Unknown command: ${command}`
   );
+  showHelp();
   process.exit(1);
 }
-
-scaffold(ebadeFile, outputDir);

package/demo.tape

@@ -0,0 +1,63 @@
+# ebade Demo Video Script
+# Run with: vhs demo.tape
+# Outputs: demo.gif + demo.mp4
+
+# Outputs - both formats
+Output demo.gif
+Output demo.mp4
+
+# Configuration
+Set FontSize 20
+Set Width 1200
+Set Height 700
+Set Theme "Catppuccin Mocha"
+Set Padding 30
+Set TypingSpeed 50ms
+Set PlaybackSpeed 1.0
+
+# Clear and prepare
+Hide
+Type "clear"
+Enter
+Sleep 500ms
+Show
+
+# Intro
+Type "# 🧠 ebade - The Agent-First Framework"
+Enter
+Sleep 1.2s
+
+Type "# Scaffold a full SaaS Dashboard in seconds..."
+Enter
+Sleep 1.5s
+
+# The magic command with npx
+Type "npx ebade scaffold examples/saas-dashboard.ebade.yaml ./output/demo"
+Sleep 500ms
+Enter
+
+# Wait for CLI output (ASCII logo + spinners + summary)
+Sleep 10s
+
+# Show generated file
+Type ""
+Enter
+Sleep 500ms
+
+Type "head -12 output/demo/AnalyticsHQ/app/page.tsx"
+Enter
+Sleep 4s
+
+# Final tagline
+Type ""
+Enter
+Type "# ✅ 51 files. ~70% fewer tokens. In 0.1s."
+Enter
+Sleep 500ms
+Type "# 🌱 Green AI. Kind to Earth."
+Enter
+Sleep 500ms
+Type "# → ebade.dev"
+Enter
+
+Sleep 3s

package/docs/GREEN-AI.md

@@ -25,7 +25,7 @@ Every token an AI generates requires:
 | Vue.js    | 420,000,000      | ~78%             | ~21.0 kg      |
 | **ebade** | **185,000,000**  | **34%**          | **~9.2 kg**   |
 
-**ebade uses 66% less compute for the same output.** 🌱
+**ebade uses 70% less compute for the same output.** 🌱
 
 ---
 
@@ -70,7 +70,7 @@ Add this to your repository to show your commitment to sustainable AI developmen
 [![Green AI](https://img.shields.io/badge/Green_AI-ebade-brightgreen)](https://github.com/ebade)
 ```
 
-> 🌱 **Built with ebade — saving 66% of AI compute.**
+> 🌱 **Built with ebade — saving 70% of AI compute.**
 
 ---
 

package/examples/saas-dashboard.ebade.yaml

@@ -0,0 +1,299 @@
+# ebade Project Definition File
+# SaaS Dashboard - Subscription-based analytics platform
+# -----------------------------------------------------------
+
+name: "AnalyticsHQ"
+type: "saas-dashboard"
+description: "Modern SaaS dashboard with subscriptions, team management, and analytics"
+
+# Core features of this SaaS
+features:
+  - user-auth
+  - team-management
+  - subscription-billing
+  - analytics-dashboard
+  - notifications
+  - api-keys
+  - audit-logs
+  - dark-mode
+  - multi-tenant
+
+# Page structure
+pages:
+  - path: "/"
+    intent: "landing-page"
+    auth: none
+    components:
+      - hero-section
+      - feature-grid
+      - pricing-table
+      - testimonials
+      - faq-accordion
+      - cta-banner
+
+  - path: "/login"
+    intent: "auth-login"
+    components:
+      - login-form
+      - social-auth-buttons
+      - forgot-password-link
+
+  - path: "/signup"
+    intent: "auth-register"
+    components:
+      - signup-form
+      - plan-selector
+      - social-auth-buttons
+
+  - path: "/dashboard"
+    intent: "main-dashboard"
+    auth: required
+    layout: "dashboard-shell"
+    components:
+      - stats-grid
+      - activity-chart
+      - recent-events
+      - quick-actions
+
+  - path: "/dashboard/analytics"
+    intent: "analytics-view"
+    auth: required
+    layout: "dashboard-shell"
+    components:
+      - date-range-picker
+      - metrics-cards
+      - line-chart
+      - bar-chart
+      - data-table
+
+  - path: "/dashboard/team"
+    intent: "team-management"
+    auth: required
+    roles: ["admin", "owner"]
+    layout: "dashboard-shell"
+    components:
+      - team-members-list
+      - invite-member-modal
+      - role-selector
+      - pending-invites
+
+  - path: "/dashboard/settings"
+    intent: "user-settings"
+    auth: required
+    layout: "dashboard-shell"
+    components:
+      - profile-form
+      - password-change
+      - notification-preferences
+      - connected-accounts
+
+  - path: "/dashboard/billing"
+    intent: "billing-management"
+    auth: required
+    roles: ["owner"]
+    layout: "dashboard-shell"
+    components:
+      - current-plan-card
+      - usage-meter
+      - upgrade-modal
+      - invoice-history
+
+  - path: "/dashboard/api-keys"
+    intent: "api-key-management"
+    auth: required
+    roles: ["admin", "owner"]
+    layout: "dashboard-shell"
+    components:
+      - api-keys-table
+      - create-key-modal
+      - key-permissions
+
+# Layouts
+layouts:
+  dashboard-shell:
+    components:
+      - sidebar-navigation
+      - topbar
+      - user-menu
+      - notification-bell
+
+# Design system
+design:
+  style: "modern-glassmorphism"
+  colors:
+    primary: "#6366f1" # Indigo
+    secondary: "#8b5cf6" # Violet
+    accent: "#06b6d4" # Cyan
+    success: "#10b981" # Emerald
+    warning: "#f59e0b" # Amber
+    error: "#ef4444" # Red
+    background: "#0f172a" # Slate 900
+    surface: "#1e293b" # Slate 800
+  font: "Inter"
+  borderRadius: "xl"
+  shadows: true
+  glassmorphism: true
+
+# Integrations
+integrations:
+  database: "supabase"
+  auth: "clerk"
+  payments: "stripe"
+  analytics: "posthog"
+  email: "resend"
+  notifications: "knock"
+
+# Subscription plans
+plans:
+  - name: "Starter"
+    price: 0
+    limits:
+      events: 1000
+      team_members: 1
+      retention_days: 7
+    features:
+      - basic-analytics
+      - email-support
+
+  - name: "Pro"
+    price: 29
+    limits:
+      events: 50000
+      team_members: 5
+      retention_days: 90
+    features:
+      - advanced-analytics
+      - api-access
+      - priority-support
+      - custom-dashboards
+
+  - name: "Enterprise"
+    price: 99
+    limits:
+      events: unlimited
+      team_members: unlimited
+      retention_days: 365
+    features:
+      - all-pro-features
+      - sso
+      - audit-logs
+      - dedicated-support
+      - sla
+
+# API Endpoints
+api:
+  - path: "/api/events"
+    methods: ["GET", "POST"]
+    auth: api-key
+    description: "Track and query analytics events"
+
+  - path: "/api/team"
+    methods: ["GET", "POST", "DELETE"]
+    auth: required
+    roles: ["admin", "owner"]
+    description: "Team member management"
+
+  - path: "/api/team/invite"
+    methods: ["POST"]
+    auth: required
+    roles: ["admin", "owner"]
+    description: "Send team invitation"
+
+  - path: "/api/billing/subscription"
+    methods: ["GET", "POST", "PUT"]
+    auth: required
+    roles: ["owner"]
+    description: "Subscription management"
+
+  - path: "/api/billing/portal"
+    methods: ["POST"]
+    auth: required
+    description: "Generate Stripe billing portal URL"
+
+  - path: "/api/api-keys"
+    methods: ["GET", "POST", "DELETE"]
+    auth: required
+    roles: ["admin", "owner"]
+    description: "API key CRUD operations"
+
+  - path: "/api/webhooks/stripe"
+    methods: ["POST"]
+    auth: webhook
+    description: "Handle Stripe webhook events"
+
+# Data models
+data:
+  Organization:
+    fields:
+      id: { type: "uuid", required: true, unique: true }
+      name: { type: "string", required: true }
+      slug: { type: "string", required: true, unique: true }
+      plan: { type: "enum", required: true } # starter, pro, enterprise
+      stripeCustomerId: { type: "string", required: false }
+      stripeSubscriptionId: { type: "string", required: false }
+      createdAt: { type: "timestamp", required: true }
+    relations:
+      - "has_many: User"
+      - "has_many: Event"
+      - "has_many: ApiKey"
+
+  User:
+    fields:
+      id: { type: "uuid", required: true, unique: true }
+      email: { type: "string", required: true, unique: true }
+      name: { type: "string", required: true }
+      avatar: { type: "string", required: false }
+      role: { type: "enum", required: true } # owner, admin, member
+      organizationId: { type: "uuid", required: true }
+      createdAt: { type: "timestamp", required: true }
+    relations:
+      - "belongs_to: Organization"
+
+  Event:
+    fields:
+      id: { type: "uuid", required: true, unique: true }
+      organizationId: { type: "uuid", required: true }
+      name: { type: "string", required: true }
+      properties: { type: "json", required: false }
+      timestamp: { type: "timestamp", required: true }
+    relations:
+      - "belongs_to: Organization"
+
+  ApiKey:
+    fields:
+      id: { type: "uuid", required: true, unique: true }
+      organizationId: { type: "uuid", required: true }
+      name: { type: "string", required: true }
+      keyHash: { type: "string", required: true }
+      permissions: { type: "array", required: true }
+      lastUsedAt: { type: "timestamp", required: false }
+      expiresAt: { type: "timestamp", required: false }
+      createdAt: { type: "timestamp", required: true }
+    relations:
+      - "belongs_to: Organization"
+
+  Invitation:
+    fields:
+      id: { type: "uuid", required: true, unique: true }
+      email: { type: "string", required: true }
+      organizationId: { type: "uuid", required: true }
+      role: { type: "enum", required: true }
+      token: { type: "string", required: true, unique: true }
+      expiresAt: { type: "timestamp", required: true }
+      acceptedAt: { type: "timestamp", required: false }
+    relations:
+      - "belongs_to: Organization"
+
+  AuditLog:
+    fields:
+      id: { type: "uuid", required: true, unique: true }
+      organizationId: { type: "uuid", required: true }
+      userId: { type: "uuid", required: true }
+      action: { type: "string", required: true }
+      resourceType: { type: "string", required: true }
+      resourceId: { type: "uuid", required: true }
+      metadata: { type: "json", required: false }
+      createdAt: { type: "timestamp", required: true }
+    relations:
+      - "belongs_to: Organization"
+      - "belongs_to: User"

package/landing/_headers

@@ -0,0 +1,6 @@
+/*
+  X-Frame-Options: DENY
+  X-Content-Type-Options: nosniff
+  X-XSS-Protection: 1; mode=block
+  Referrer-Policy: strict-origin-when-cross-origin
+  Permissions-Policy: camera=(), microphone=(), geolocation=()

package/landing/index.html

@@ -6,7 +6,7 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>ebade | The First Agent-First Framework</title>
   <meta name="description"
-    content="ebade is the first framework designed FOR AI agents, readable by humans. Reduce token usage by 66% with intent-driven development." />
+    content="ebade is The first framework designed for AI agents, readable by humans. Reduce token usage by 70% with intent-driven development." />
 
   <!-- Favicon -->
   <link rel="icon" type="image/svg+xml" href="favicon.svg" />
@@ -16,14 +16,24 @@
   <meta property="og:url" content="https://ebade.dev/" />
   <meta property="og:title" content="ebade | The First Agent-First Framework" />
   <meta property="og:description"
-    content="The first framework designed FOR AI agents. Reduce token usage by 66% with intent-driven development." />
+    content="The first framework designed FOR AI agents. Reduce token usage by 70% with intent-driven development." />
   <meta property="og:image" content="https://ebade.dev/og-image.png" />
 
   <!-- Twitter -->
   <meta name="twitter:card" content="summary_large_image" />
   <meta name="twitter:title" content="ebade | The First Agent-First Framework" />
-  <meta name="twitter:description" content="The first framework designed FOR AI agents. Reduce token usage by 66%." />
+  <meta name="twitter:description" content="The first framework designed FOR AI agents. Reduce token usage by 70%." />
   <meta name="twitter:image" content="https://ebade.dev/og-image.png" />
+
+  <!-- Google tag (gtag.js) -->
+  <script async src="https://www.googletagmanager.com/gtag/js?id=G-RMQ7E747ZH"></script>
+  <script>
+    window.dataLayer = window.dataLayer || [];
+    function gtag() { dataLayer.push(arguments); }
+    gtag('js', new Date());
+
+    gtag('config', 'G-RMQ7E747ZH');
+  </script>
   <link rel="preconnect" href="https://fonts.googleapis.com" />
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
   <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@400;600;800;900&family=JetBrains+Mono&display=swap"
@@ -45,7 +55,7 @@
         <i data-lucide="github"></i>
         <span>GitHub</span>
       </a>
-      <a href="https://github.com/hasankemaldemirci/ebade#quick-start" target="_blank" class="nav-cta">Get Started</a>
+      <a href="https://github.com/hasankemaldemirci/ebade#-quick-start" target="_blank" class="nav-cta">Get Started</a>
     </div>
   </nav>
 
@@ -55,7 +65,7 @@
         <div class="badge-modern">
           <i data-lucide="cpu" class="icon-small"></i> Protocol 0.1.0 // Alpha
         </div>
-        <h1 class="glitch-text">The Essence of <span>Code</span></h1>
+        <h1 class="glitch-text">Code = f(<span>Intent</span>)</h1>
         <p class="hero-description">
           <span class="ebade-brand">ebade</span> is an evolution in abstract
           engineering. We don't build components; we model intent. Designed
@@ -155,13 +165,13 @@
         <div class="stats-box">
           <div class="stat">
             <div class="stat-icon"><i data-lucide="zap"></i></div>
-            <span class="val">66%</span>
+            <span class="val">70%</span>
             <span class="label">Token Reduction</span>
           </div>
           <div class="stat-divider"></div>
           <div class="stat">
             <div class="stat-icon"><i data-lucide="brain"></i></div>
-            <span class="val">2.9x</span>
+            <span class="val">4.1x</span>
             <span class="label">Agent Context Efficiency</span>
           </div>
           <div class="stat-divider"></div>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ebade",
-  "version": "0.1.0",
-  "description": "ebade - Agent-First Framework. The first framework designed FOR AI agents, readable by humans.",
+  "version": "0.2.1",
+  "description": "ebade - Agent-First Framework. The first framework designed for AI agents, readable by humans.",
   "type": "module",
   "main": "cli/scaffold.js",
   "bin": {
@@ -30,11 +30,12 @@
     "type": "git",
     "url": "git+https://github.com/hasankemaldemirci/ebade.git"
   },
-  "homepage": "https://github.com/hasankemaldemirci/ebade#readme",
+  "homepage": "https://ebade.dev",
   "bugs": {
     "url": "https://github.com/hasankemaldemirci/ebade/issues"
   },
   "dependencies": {
+    "ora": "^9.0.0",
     "yaml": "^2.3.4"
   },
   "engines": {