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 →

Try It In 60 Seconds

Break anything — the database wipes every 4 hours.

→ Open the live demo (admin access)

Or scaffold your own project once you have a license:

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 ↑.

🗣️ 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 — CLI, scaffolding, license validation, or the RED boilerplate itself.
• 💡 Request a feature — AI Module primitives, stack decisions, developer experience.
• 💬 Start a discussion — 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 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. Run it without installing:

# 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

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

bunx create-red-app versions

Outputs semver-sorted JSON to stdout. Includes prereleases, marks the latest stable.

Show release details

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

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.
• RED boilerplate, AI Module, and Claude skills — commercial license per tier. See pricing →

Both flip to a fully permissive open-source license when this repository reaches 10,000 ⭐. See The 10k Pledge.