Lean SaaS starter for Code Wave products. Built on:
@codewavebr/wavecore— tenant, auth contracts, billing helpers, Next adapter@codewavebr/wavekit— HeroUI UI, theme, dashboard shell (with brand mark)
No database, auth provider, or payment gateway is wired by default. Stubs keep the app runnable; production steps live under docs/.
bun install
bun run devPackages are public on npm — no token or .npmrc needed.
Optional: if you have local package checkouts next to this repo, postinstall / bun run link:packages can override node_modules with local builds.
Open http://localhost:3000 — you will be redirected to /login. Pick a demo user.
Recommended host: Vercel (full Next.js App Router, no static export).
- Import the GitHub repo at vercel.com/new.
- Framework preset: Next.js. Install/build:
bun install/bun run build(already invercel.json). - Env (optional for the demo):
NEXT_PUBLIC_ROOT_DOMAIN=your-app.vercel.app
NEXT_PUBLIC_THEME_COLOR=10 96% 65%
- Deploy. Every push to
mainupdates production.
CLI alternative:
bunx vercel
bunx vercel --prodDemo session uses localStorage (lib/session.ts). For production auth, swap to cookies/lib/actions.ts or NextAuth/Clerk — Vercel supports server features that GitHub Pages did not.
| Layer | Choice |
|---|---|
| Runtime | Next.js 15 App Router, React 19, Bun |
| UI | WaveKit + HeroUI v3 + Tailwind CSS v4 |
| Platform | WaveCore tenant/billing contracts |
| Persistence | In-memory stubs (lib/*) |
| Hosting | Vercel |
app/
login/ mock sign-in
app/ dashboard shell routes
components/ providers, brand, AppShell
lib/
demo.ts users/tenants/plans stubs (client-safe)
session.ts localStorage session (demo)
auth.ts cookie session helpers (Node/Vercel)
tenant.ts wavecore/next adapter (Node/Vercel)
billing.ts re-exports plan helpers
actions.ts server-action sign-in (Node/Vercel)
docs/
DATABASE.md wire Postgres + Drizzle
MULTI_TENANT.md domain routing + adapter
BILLING.md plans, webhooks, gates
bun run dev
bun run typecheck
bun run build
bun run start