Your first app, one piece at a time

The steps

1. Step 1

   Pick your pieces

   Each piece does one job, such as signing people in or taking payments. On the recipe page, tick the ones your app needs.

   • Ticking a piece also ticks the pieces it relies on, so nothing is left out.
   • Not sure? Start with no extra pieces. The basics always come with your app.
2. Step 2

   Make a free account

   Sign up with your email, or with Google. It takes a minute and lets you download.

   • Check your inbox for the confirmation email, then sign in.
3. Step 3

   Download your starter app

   Name your app and press Download. You get one zip file with a working app and your pieces already in place.

   • Inside is a file called START-HERE.md. It repeats these steps for your exact app.
4. Step 4

   Get it running on your computer

   Install two free tools once, then type two short commands. Your app opens in your browser.

   • Install Node.js, the LTS version from nodejs.org, and Bun from bun.sh.
   • Unzip the file. On Windows, right click the folder and choose Open in Terminal. On a Mac, open Terminal, type cd and a space, and drag the folder in.
   • Type bun install and press Enter. Then type bun run dev and press Enter. Open the address it shows.
5. Step 5

   Add the database part, if you need one

   Some pieces keep records, so they need a database. Supabase gives you one for free.

   • Make a free Supabase project and open its SQL Editor.
   • Run each file in the app's supabase/migrations folder, in name order. Copy, paste, press Run, then the next one.
   • No database pieces? Skip this step.
6. Step 6

   Make it yours

   Build your own screens on top. The pieces stay as they are, so they keep working and stay safe.

   • Your screens go in src/routes. Your name and colours go in src/app.config.ts and src/styles.css.
   • Each piece has a CONTRACT.md that says how to use it. Leave the src/blocks folder alone.