Skip to main content
Satūs/

Start here

Satūs

A starter, not a product. The steps below take you from a fresh clone to something you can ship. When you're ready, replace this page with your own.

  1. 01

    Run it

    Install dependencies, then start the dev server. It runs on localhost:3000.

    bun install
    bun dev
  2. 02

    Make it yours

    Env vars live in the repo, encrypted: add one with bun dotenvx set, then bun run env:setup hands the key to Vercel. On Vercel the site's domain is picked up automatically.

    The site title and SEO live in app/(site)/layout.tsx. Fonts are in lib/styles/fonts, colors and theme tokens in lib/styles/colors.

    Swap in your own favicon and app/opengraph-image.jpg.

    bun dotenvx set KEY "value"
  3. 03

    Shape the chrome

    The header, footer, and page shell live in components/layout. The header and footer are already part of Wrapper, so you don't add them on each page.

    Pages are laid out with one grid class: dr-layout-grid.

  4. 04

    Browse components

    UI primitives live in components/ui, one folder each with its styles beside it. The full inventory of components, hooks, and utilities is in COMPONENTS.md.

  5. 05

    Add a plugin

    Integrations like Sanity, Shopify, HubSpot, and WebGL stay tucked away in lib/integrations. They do nothing until you set them up.

    To turn one on, set its env vars and follow the in-folder notes marked // USAGE. Choose what to keep with bun run setup:project — keeping one also keeps whatever it requires (e.g. keeping theatre keeps webgl).

  6. 06

    Ship

    Run the checks and build, then deploy.

    bun run check
    bun run build

    Or skip the wait and deploy to Vercel in one click.

Done here? Replace app/(site)/page.tsx with your homepage and delete page.module.css. That's the only cleanup.