Overview
Run locally, customize the product, and deploy to your own Cloudflare account.
MuseMVP Flare is a standalone TanStack Start + Cloudflare SaaS source template. Its single apps/web application builds into a Worker through Vite and the native Cloudflare plugin, with D1, private R2, Email Sending, Workers AI and Queues.
Open the live demo. Use it to inspect the interface and public journeys. Local seed credentials do not apply to that site, and the demo does not certify integrations in your own account.
Recommended path
| Goal | Guide | Expected result |
|---|---|---|
| Get the project | Get source | Independent checkout, toolchain and private remote |
| First run | Quick start | Working local account and development mailbox |
| Make it your product | Brand Configuration | Name, logo, copy, theme and catalog |
| Connect services | Environment variables | Separate local, CLI and Worker settings |
| Publish | Deployment | Your resources, domain, migrations and public smoke checks |
| Develop features | Project structure | Clear ownership of routes, services, queries and UI |
Included capabilities
- Accounts: password/email verification, email OTP, Google/GitHub OAuth, two-factor authentication, sessions, API keys and admin roles.
- Workspace: overview, files, AI, billing, usage, settings and onboarding; admin views for users, orders, tasks, webhooks, audit, refunds and dead letters.
- Business foundations: private file ownership, credit ledger, streaming generation, queued summaries, webhook inbox/outbox and idempotent retries.
- Interface and content: app-local shadcn/Base UI components, English/Chinese MDX, Geist/Fraunces typography, system/light/dark preferences.
- Delivery tools: local initialization, account diagnostics, deployment planning, named resources and public smoke verification.
Run before connecting services
pnpm install --frozen-lockfile
pnpm muse:init
pnpm devOpen http://localhost:3000. Follow Quick start for credentials, ports, mail verification and success checks. A first local run requires no Cloudflare API token or merchant account.
Billing starts disabled. AI has no local model emulator; real generation requires an explicit Cloudflare connection. Production exposes no development mailbox and never seeds local admin users.
Relationship to other products
MuseMVP and All in One include Flare source; UI Templates excludes the engineering foundation. The original musemvp repository contains two Next.js apps. Flare is independent and does not require that checkout to run.
Next.js UI templates can supply designs and content, but TanStack integration requires adapting routing, links, images and server component assumptions. Do not import OpenNext, PostgreSQL or Next.js folder conventions into Flare.
Acceptance levels
A reachable demo, passing source tests and working integrations in your account are separate results. CLI smokePassed checks public HTTP surfaces; actual email, OAuth, AI and merchant transactions require separate acceptance. See Testing, Troubleshooting and source docs/RELEASE.md.