IDE + Terminal Basics

An IDE is where you browse files, inspect code, and make changes. The terminal is where you start the app, run checks, and use scripts.

You do not need to become a shell expert to use this starter well. You need a short list of commands and a clear sense of when to run them.

Commands you will actually use

bun install
bun run dev
bun run dev:full
bun run dev:web
bun run dev:convex
bun run build
bun run check

What each one does

• bun install installs dependencies
• bun run dev starts the app locally and keeps your hosted Convex dev deployment synced
• bun run dev:full starts the app, hosted Convex dev sync, and Stripe forwarding together
• bun run dev:web starts only the Next.js side
• bun run dev:convex connects or refreshes your hosted Convex dev deployment
• bun run build proves the app still compiles
• bun run check runs the full local gate

When the page feels stale

If the app stops reflecting new changes or provider state:

1. stop the running local services
2. start them again with bun run dev
3. retry the flow before assuming the code is wrong

What success looks like

You are in good shape when you can start the app, restart it cleanly, and run the basic verification commands without guessing.