ebade 0.2.2 → 0.4.0

package/CHANGELOG.md

@@ -9,6 +9,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **Playground UI** - Interactive "Battle Mode" simulation comparing Legacy AI vs ebade-powered Agent.
+- **Shadcn/UI Integration** - All component templates now use Shadcn design patterns.
+- **20+ Component Templates** - navbar, footer, pricing-table, login-form, signup-form, and more.
+- **File-based Template System** - Dynamic template loading from `cli/templates/`.
+- **Real-time Token Savings** - CLI now displays actual token savings during scaffold.
 - MCP Server branding update to **ebade**.
 - Green AI Metrics and Carbon Impact calculations.
 - Turkish identity integration (Badik mascot 🐣 and "The Essence of Code" vision).

package/README.md

@@ -1,4 +1,4 @@
-# ebade 🧠
+# ebade
 
 ![ebade - The First Agent-First Framework](https://ebade.dev/og-readme.png)
 
@@ -8,17 +8,18 @@
 [![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-70%25_Less_Tokens-brightgreen)](./docs/GREEN-AI.md)
+[![Agent-Native](https://img.shields.io/badge/Agent--Native-Universal_AI_Support-black)](./SYNTAX.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.**
 >
 > `Code = f(ebade)`
 >
-> *Capture the essence of code. Less tokens. Less carbon. Same result.* 🌱
+> _Capture the essence of code. Less tokens. Less carbon. Same result._ 🌱
 
 ## 🎬 See it in action
 
-![ebade demo](./demo.gif)
+![ebade demo](./assets/demo.gif)
 
 ```typescript
 
@@ -70,42 +71,51 @@ Then AI agents can use:
 ### For Humans (CLI)
 
 ```bash
-# Scaffold a new project
-npx ebade scaffold --type e-commerce --name my-store
+# Scaffold a new project from an ebade file
+npx ebade scaffold examples/saas-dashboard.ebade.yaml ./my-app
 
-# Compile intents to code
-npx ebade build
-
-# Watch mode
-npx ebade dev
+# See all commands
+npx ebade --help
 ```
 
 ---
 
+## 🤖 Integrated AI Synergy
+
+**ebade** projects automatically configure themselves for AI collaboration. When you scaffold a project, it generates specialized instruction files for major AI agents:
+
+- **Cursor**: `.cursorrules`
+- **Claude / Windsurf**: `.clauderules`
+- **GitHub Copilot**: `.github/copilot-instructions.md`
+
+These files teach the AI agents exactly how to work with ebade intents, ensuring they never "hallucinate" boilerplate and always stay token-efficient.
+
+---
+
 ## 📊 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 |
-| SaaS Dashboard ⭐ | 1,850 tokens | 245 tokens | **86.8%** | 7.6x |
-| **Average** | | | **68.8%** | **4.1x** |
+| 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       |
+| 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%.*
+> _For full project scaffolding, savings can reach 75-92%._
 
 ### 💰 Cost Impact
 
 At scale (1M AI coding sessions):
 
-| Framework | Token Cost | Savings |
-| :--- | :--- | :--- |
-| Next.js | $5,390 | - |
+| Framework | Token Cost | Savings    |
+| :-------- | :--------- | :--------- |
+| Next.js   | $5,390     | -          |
 | **ebade** | **$1,850** | **$3,540** |
 
-> *The greenest code is the code you don't generate.*
+> _The greenest code is the code you don't generate._
 
 📄 [Full Benchmark Results](./benchmarks/RESULTS.md) | 🌱 [Green AI Manifesto](./docs/GREEN-AI.md)
 
@@ -139,12 +149,12 @@ 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/compiler` | Advanced Intent Compiler | 🚧 Planning |
-| `@ebade/vscode` | VS Code extension | 📋 Planned |
+| Package                                    | Description              | Status      |
+| :----------------------------------------- | :----------------------- | :---------- |
+| **`ebade`**                                | Core Framework & CLI     | ✅ Alpha    |
+| [@ebade/mcp-server](./packages/mcp-server) | MCP Server for AI agents | ✅ Alpha    |
+| `@ebade/compiler`                          | Advanced Intent Compiler | 🚧 Planning |
+| `@ebade/vscode`                            | VS Code extension        | 📋 Planned  |
 
 ---
 
@@ -204,15 +214,16 @@ pages:
       - hero-section
       - featured-products
       - testimonials
-      
+
   - path: /products
     intent: product-listing
     components:
       - search-bar
       - product-grid
       - pagination
-      
+
   - path: /checkout
+
     intent: checkout-flow
     auth: required
     components:
@@ -226,12 +237,12 @@ 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" |
-| **2026** | **ebade** | **"What if Code = f(intent)?"** |
+| 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" |
+| **2026** | **ebade** | **"What if Code = f(intent)?"**  |
 
 ---
 
@@ -277,5 +288,5 @@ MIT © ebade Contributors — Made with ❤️ in Türkiye 🇹🇷
 
 **Built for AI. Readable by humans. Revolutionary by design.**
 
-*TypeScript made JavaScript better for humans.*
-*ebade makes frameworks better for AI.*
+_TypeScript made JavaScript better for humans._
+_ebade makes frameworks better for AI._

package/ROADMAP.md

@@ -14,12 +14,12 @@ It's more efficient, deterministic, and KIND TO EARTH. 🌱
 
 ## Phase 1: Foundation (Week 1-2) ✅ COMPLETE
 
-### 1.1 MCP Server ✅
+### 1.1 MCP Server ✅ (v0.3.1 Synced)
 
-Make ebade usable by AI agents RIGHT NOW.
+Make ebade usable by AI agents RIGHT NOW. Direct integration with Claude Desktop & Cursor.
 
 - [x] Create MCP server package
-- [x] `ebade_scaffold` tool - generate project from ebade
+- [x] `ebade_scaffold` tool - Updated to v0.3.1 templates (SaaS, E-commerce, Landing)
 - [x] `ebade_validate` tool - validate ebade file
 - [x] `ebade_compile` tool - compile single ebade to code
 - [x] `ebade_generate` tool - infer ebade from natural language
@@ -44,25 +44,30 @@ Replace string templates with actual AST-based compilation.
 - [ ] Code generator (AST → React/Next.js)
 - [ ] Support for multiple framework targets
 
-### 1.5 CLI Improvements
+### 1.5 CLI & Developer Experience ✅ (v0.3.1)
 
-- [ ] `ebade init` - interactive project setup
-- [ ] `ebade dev` - watch mode with local agent sync
+- [x] `ebade init` - interactive project setup
+- [x] `ebade dev` - watch mode with local agent sync
+- [x] Agent Synergy - Auto-gen rules for Cursor/Claude/Copilot
+- [x] **TDD by Default** - Automatic Vitest config & .test.tsx generation 🧪
+- [x] **Tailwind CSS Native** - Built-in styling engine integration
 
 ---
 
-## Phase 2: Developer Experience (Week 3-4)
+## Phase 2: Developer Experience ✅ (v0.3.1 Core / v0.3.2 Extension)
 
-### 2.1 VS Code Extension
+### 2.1 VS Code Extension ✅
 
-- [ ] Syntax highlighting for ebade decorators
-- [ ] Autocomplete for inferred patterns
+- [x] Syntax highlighting for ebade decorators
+- [x] Snippets for project/page/api/data
 - [ ] Inline token usage counter (Carbon counter! 🌱)
 
 ### 2.2 Playground Website
 
+- [x] **Battle Mode Simulation** - Legacy AI vs ebade comparison
+- [x] Real-time token counter and speed metrics
+- [x] Output comparison (code quality)
 - [ ] Live editor (Monaco)
-- [ ] Real-time compilation preview
 - [ ] Share ebade via URL
 
 ### 2.3 Documentation Site
@@ -122,10 +127,10 @@ Replace string templates with actual AST-based compilation.
 
 ## Current Status
 
-**Phase 1 - Foundation** ← NEARLY COMPLETE
+### Phase 1 - Foundation ✅ (v0.3.1 - The Testing Era)
 
-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**.
+The MCP server is live and fully synced. CLI has premium UX and now generates **production-ready code** with Tailwind CSS and automatic Unit Testing (Vitest). AI agents can now use ebade to scaffold full Next.js apps with **~80% fewer tokens** while maintaining high code quality through TDD.
 
 ---
 
-*Last updated: 2026-01-07*
+Last updated: 2026-01-09 (Playground & Shadcn Update)