Quickstart
Go from an empty folder to a running CoreMVP app with sign-in and a saved Project. The steps are the same for Next.js and TanStack Start. Where a command differs, pick your framework in the tabs and every tab on the page follows.
Before you start
Install these tools:
| Tool | Version | Check |
|---|---|---|
| Git | Any current release | git --version |
| Bun | 1.4 or later | bun --version |
| Node.js | 22.23.4 or later on 22.x, or 24.22.1 or later on 24.x | node --version |
| Docker | Running before you start Supabase | docker info |
You need access to your template's private repository; After Purchase explains how to claim it. Payment providers and email are not needed for the first run.
Run the app
Clone and install
git clone https://github.com/coremvp/nextjs.git <my-app>
cd <my-app>
bun install --frozen-lockfilegit clone https://github.com/coremvp/tanstack-start.git <my-app>
cd <my-app>
bun install --frozen-lockfileRun every later command from this folder. If Git reports
Repository not found, Git is using a GitHub account without access to the
repository. Use the account that received the invitation, or see
Repository access needs repair.
Start local Supabase
bunx supabase startThe repository already includes its Supabase configuration and migrations,
so do not run supabase init. The first start downloads Docker images and
can take several minutes. It finishes by printing the local API and Studio
URLs.
Verify the local schema
bunx supabase migration list --localEvery migration is listed under both Local and Remote. If one is missing, see Troubleshooting.
Generate local settings
./coremvp env syncThe CoreMVP CLI reads the running Supabase stack and writes the app URL, Supabase keys and database connection to . Warnings about unset billing or email settings are expected at this point.
Start the app
bun run devOpen http://localhost:3000 and the app's home page loads. Leave this process running.
Save your first Project
The app is ready when a record you create survives a reload.
Create an account
Open http://localhost:3000/signup and sign up with any email and a password of at least 8 characters. The included local settings do not require email confirmation. After sign-up the app opens its pricing page; you do not need to buy anything to continue.
Create a Project
Open http://localhost:3000/dashboard, choose your Personal Organization, then open Projects in the sidebar. Choose New project, enter a Project name, and select Create Project.
Reload the page
The app opens the new Project's page. Reload it: the Project still loads, and it is listed when you open Projects again. Sign-up, the dashboard and the database work together, and your local setup is complete.
Troubleshooting
| Symptom | Fix |
|---|---|
| You bought CoreMVP but cannot open the TanStack Start repository | Email [email protected] with your GitHub username so support can grant access to coremvp/tanstack-start. |
bun: command not found | Install Bun or add it to your shell PATH, then open a new terminal. |
Cannot connect to the Docker daemon | Start Docker, then rerun bunx supabase start. |
./coremvp env sync reports that Supabase is not running | Run bunx supabase start, wait for the URLs, then sync again. |
A Supabase port or port 3000 is already in use | Stop the other app or Supabase project. To run two Next.js checkouts at once, follow Run another project. |
| A migration is missing from Local or Remote | On a new, empty database, run bunx supabase db reset --local and list the migrations again. Reset deletes local data. |
template database "template1" has a collation version mismatch | Recreate local data with bunx supabase stop --no-backup && bunx supabase start. This deletes this checkout's local data. |
| The dashboard cannot load data | Run ./coremvp env list to see which settings are set without printing values. Sync again, then restart bun run dev. |
What's next
Projects
Application Architecture
Keep your product in your own repository
Billing
Was this page helpful?