Initial commit

Author: Pierozi

.github/workflows/publish-cli.yml

@@ -0,0 +1,55 @@
+name: Publish CLI
+
+on:
+  push:
+    tags:
+      - "cli-v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
+        with:
+          bun-version: latest
+
+      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        with:
+          node-version: "22"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Upgrade npm for trusted publishing
+        run: npm install -g npm@latest
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Type check
+        run: bun run typecheck
+
+      - name: Lint
+        run: bun run lint
+
+      - name: Run tests
+        run: bun test
+
+      - name: Build
+        run: bun run build
+
+      - name: Publish to npm
+        run: npm publish --access public
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${GITHUB_REF_NAME#cli-v}"
+          gh release create "$GITHUB_REF_NAME" \
+            --title "create-red-app v${VERSION}" \
+            --generate-notes

.gitignore

@@ -0,0 +1,8 @@
+node_modules/
+dist/
+.DS_Store
+Thumbs.db
+.env
+.env.local
+coverage/
+*.tgz

CLAUDE.md

@@ -0,0 +1,10 @@
+## Critical Rules
+
+Produce code following **LEAN, CLEAN, MINIMAL but thoughtful YAGNI style**
+
+- No semicolons in TypeScript
+- Use `bun` as package manager
+- Run `bun run lint` before completing work
+- Always use `git mv` (not `mv`) when moving or renaming files to preserve git history
+- Use early return, avoid if-else-elseif chains
+- Always refer to official doc, never assume you know everything

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dev3o
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,177 @@
+<h1 align="center">RED — The Agentic-Native Starter Kit</h1>
+
+<p align="center">
+  <strong>Ship your agentic startup by the weekend.</strong>
+</p>
+
+<p align="center">
+  From hackathon prototype to production SaaS — RED gives you the Agentic-Native stack in 90 minutes.<br />
+  So your next 3 months build the product, not the plumbing.
+</p>
+
+<p align="center">
+  <a href="https://red.dev3o.com"><strong>Website</strong></a> &bull;
+  <a href="https://red-demo.dev3o.com"><strong>Live Demo</strong></a> &bull;
+  <a href="https://red.dev3o.com/docs"><strong>Docs</strong></a> &bull;
+  <a href="https://red.dev3o.com/#pricing"><strong>Pricing</strong></a> &bull;
+  <a href="https://github.com/agentic-dev3o/red/issues"><strong>Issues</strong></a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/create-red-app?label=create-red-app&color=D4483B" alt="npm version" />
+  <img src="https://img.shields.io/github/stars/agentic-dev3o/red?style=flat&label=stars%20%2F%2010k&color=D4483B" alt="GitHub Stars" />
+</p>
+
+<p align="center">
+  <em>⭐ <strong>10,000 stars → RED becomes fully open source.</strong> See <a href="#-the-10k-pledge">The 10k Pledge</a>.</em>
+</p>
+
+---
+
+## Why RED
+
+Every SaaS is becoming agentic. Most starter kits bolt a streaming chat on top of a Next.js boilerplate and call it a day. RED picks a side: the AI Module is the **spine**, and the SaaS plumbing wraps around it.
+
+- **5 AI primitives, production-grade** — multi-party streaming, message queue, boundaries (per-project brain), agent abstraction, sync tasks.
+- **The headliner: external async tasks** — long-running work, off the main thread, streams progress back and notifies on completion. Deep research, batch scraping, multi-step agent pipelines, video renders — the things LLM wrappers can't do.
+- **SaaS-complete, not Frankenstack** — passkeys & 2FA auth, orgs & RBAC, metered billing (Autumn + Stripe), admin dashboard, audit logs, i18n, transactional email, waitlist.
+- **One opinionated stack** — Convex · React 19 · Bun · Vite · Tailwind v4 · shadcn/ui · Better Auth · Zod · Autumn · Resend · Lingui · Biome.
+- **Deploy anywhere** — managed free-tier cloud (Convex + Cloudflare) or self-hosted on your own box. Same codebase.
+
+[**Explore RED on red.dev3o.com →**](https://red.dev3o.com)
+
+---
+
+## Try It In 60 Seconds
+
+Break anything — the database wipes every 4 hours.
+
+**[→ Open the live demo (admin access)](https://red-demo.dev3o.com)**
+
+Or scaffold your own project once you have a license:
+
+```bash
+bun create red-app my-saas --license YOUR_LICENSE_KEY
+cd my-saas
+claude
+/red-init
+```
+
+One command validates your license, downloads the latest stable release, verifies its SHA-256 checksum, and extracts a ready-to-use project with the Claude skills pre-installed.
+
+---
+
+## ⭐ The 10k Pledge
+
+**When this repository reaches 10,000 GitHub stars, RED becomes fully open source.**
+
+No strings. No conditions. No small print. The entire codebase — CLI, boilerplate, AI Module, Claude skills — flips to a permissive open-source license the day we cross 10,000 ⭐.
+
+Every star moves that needle. If you think Agentic-Native tooling should be accessible to every builder on the planet, **[hit the star button at the top of this page ↑](https://github.com/agentic-dev3o/red)**.
+
+<p align="center">
+  <a href="https://github.com/agentic-dev3o/red">
+    <img src="https://img.shields.io/github/stars/agentic-dev3o/red?style=for-the-badge&label=stars%20toward%2010k&color=D4483B&logo=github" alt="Stars toward 10k" />
+  </a>
+</p>
+
+---
+
+## 🗣️ Feature Requests & Bug Reports
+
+This repository is RED's public home — where the community reports bugs, requests features, and helps shape the roadmap.
+
+- 🐛 **[Report a bug](https://github.com/agentic-dev3o/red/issues/new?template=bug_report.md)** — CLI, scaffolding, license validation, or the RED boilerplate itself.
+- 💡 **[Request a feature](https://github.com/agentic-dev3o/red/issues/new?template=feature_request.md)** — AI Module primitives, stack decisions, developer experience.
+- 💬 **[Start a discussion](https://github.com/agentic-dev3o/red/discussions)** — questions, stack tradeoffs, "is this the right tool for my use case?".
+
+Before opening an issue, please search existing ones — there is a fair chance someone hit the same thing.
+
+### Built with RED
+
+Shipping a product on RED? We'd love to feature it. [Open a PR against `SHOWCASE.md`](https://github.com/agentic-dev3o/red/edit/main/SHOWCASE.md) with a link, a one-line description, and a screenshot.
+
+---
+
+## About This Repo
+
+This repo serves two purposes:
+
+- **Public CLI (`create-red-app`)** — open source, published to npm under MIT. This is what buyers use to scaffold and upgrade RED projects.
+- **Community home** — issues, discussions, showcase, and the star-tracked road to open source.
+
+The product source (boilerplate + AI Module + Claude skills) is private today and delivered as signed, checksum-verified release archives through the CLI. It flips to open source when the 10k pledge triggers.
+
+---
+
+## CLI Reference
+
+The CLI is published to npm as [`create-red-app`](https://www.npmjs.com/package/create-red-app). Run it without installing:
+
+```bash
+# Bun (recommended)
+bun create red-app <directory> --license <key>
+
+# Or via bunx / npx
+bunx create-red-app <directory> --license <key>
+npx  create-red-app <directory> --license <key>
+```
+
+### Commands
+
+#### Scaffold a new project
+
+```bash
+bun create red-app <directory> --license <key> [--version <ver>]
+```
+
+Validates the license, downloads the latest stable release (or a pinned `--version`), verifies SHA-256 integrity, and extracts into the target directory with `.red-license`, `.red-version`, and Claude skills intact.
+
+#### List available releases
+
+```bash
+bunx create-red-app versions
+```
+
+Outputs semver-sorted JSON to stdout. Includes prereleases, marks the latest stable.
+
+#### Show release details
+
+```bash
+bunx create-red-app info <version>
+```
+
+Outputs normalised release metadata as JSON — changelog, migration manifest (always a parsed object), checksum, and more.
+
+#### Download a release
+
+```bash
+bunx create-red-app download <version>
+```
+
+Downloads and extracts a release to a temp directory without touching your project. Outputs JSON with `version`, `archiveFileName`, `archivePath`, and `extractedPath`. Inspection primitive used by the `red-update` Claude skill.
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--license <key>` | License key. Also read from the `RED_LICENSE_KEY` env var or `.red-license` in the current directory. |
+| `--version <ver>` | Pin the scaffold to a specific release version. |
+| `--api-url <url>` | Override the license API base URL (staging / local dev). |
+| `-h, --help` | Show help. |
+| `-v, --version` | Show CLI version. |
+
+---
+
+## License
+
+- **CLI (`create-red-app`)** — MIT. See [LICENSE](LICENSE).
+- **RED boilerplate, AI Module, and Claude skills** — commercial license per tier. [See pricing →](https://red.dev3o.com/#pricing)
+
+Both flip to a fully permissive open-source license when this repository reaches **10,000 ⭐**. See [The 10k Pledge](#-the-10k-pledge).
+
+---
+
+<p align="center">
+  Built by <a href="https://dev3o.com"><strong>dev3o</strong></a> — the boring parts that actually matter.
+</p>

SHOWCASE.md

@@ -0,0 +1,38 @@
+# Built with RED
+
+Real products shipping on the RED stack. Add yours below.
+
+---
+
+## Aporia
+
+**The AI product thinking partner that forces clarity before code.**
+
+A Socratic interrogation platform for founders and product teams. Aporia uses an opinionated AI interlocutor to extract tacit product decisions — surfacing contradictions, challenging assumptions, and forcing the choices founders tend to avoid. Built on RED's AI Module for multi-party streaming, persistent agent memory via boundaries, and long-running deep-thinking tasks.
+
+- 🌐 **Website:** [useaporia.com](https://useaporia.com)
+- 🧱 **Built on:** RED (Convex · React 19 · Bun · Better Auth · Autumn)
+- 🤖 **AI Module usage:** agents, boundaries, sync tasks, external async tasks (for deep research)
+- 👤 **By:** [Pierre TOMASINA](https://github.com/pierozi)
+
+---
+
+## Add Your Product
+
+Shipping something on RED? We'd love to feature it.
+
+**How to submit:**
+
+1. [Fork this repo](https://github.com/agentic-dev3o/red/fork) and open `SHOWCASE.md`.
+2. Add an entry at the **top of the list** (most recent first), following the template below.
+3. Keep it honest — no fluff, no marketing speak.
+4. Open a pull request with the title `showcase: <your product name>`.
+
+
+### Guidelines
+
+- **One entry per product.** If you ship multiple products on RED, that's fantastic — open one PR per product.
+- **Be concrete about AI Module usage.** "Uses the AI Module" says nothing. "Uses boundaries to scope memory per customer workspace, and external async tasks for overnight report generation" is useful.
+- **We reserve the right to edit for clarity** and to reorder entries occasionally (e.g. highlighting a product with a particularly instructive integration).
+
+Thank you for building in public with RED.

biome.json

@@ -0,0 +1,52 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.4.11/schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"ignoreUnknown": false,
+		"includes": ["src/**", "scripts/**", "test/**"]
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab"
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"style": {
+				"noUselessElse": "error"
+			}
+		}
+	},
+	"overrides": [
+		{
+			"includes": ["**/*.test.ts", "**/*.test.tsx", "**/*.integration.test.ts"],
+			"linter": {
+				"rules": {
+					"suspicious": {
+						"noExplicitAny": "off"
+					}
+				}
+			}
+		}
+	],
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double",
+			"lineWidth": 120,
+			"semicolons": "asNeeded"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}