From zip to shipped

Start in 5 minutes

You need Node 22 or newer and pnpm (npm i -g pnpm). Then, inside the unzipped folder:

pnpm install
pnpm dev        # http://localhost:4321
pnpm build      # production build in dist/
pnpm check      # type-check everything

Your copy lives in plain files: site identity in src/config/siteData.json.ts, navigation in navData.json.ts, pricing, FAQ and legal next to them. Blog posts are markdown files in src/data/blog/.

allowBuilds:
  esbuild: true
  sharp: true

Where everything lives

src/
  config/       your content: identity, nav, pricing, FAQ, legal
  data/         blog posts, authors, integrations (markdown + json)
  components/
    Sections/   the page blocks you rearrange
    ui/         43 primitives (buttons, dialogs, tables...)
    islands/    the 3 React islands
    three/      the WebGL ocean
  pages/        one file per route
  styles/       tokens.css = the whole design system
scripts/        rebrand.mjs, og.mjs
wiki/           how it all fits, for humans and agents

Rebrand in one command

Give the theme your brand color and the entire palette regenerates: components, dark mode, even the generated social images follow.

pnpm rebrand "#7a59ff"          # your accent color
pnpm rebrand "#7a59ff" --dark "#140a2e"
pnpm rebrand --restore           # back to the original Aloha palette
pnpm og                          # regenerate the OG images to match

Deploy for free

The build is plain static files, so the free tier of any modern host carries it. Cloudflare: create a project, point it at your repo, build command pnpm build, output dist. Netlify and Vercel: same two values. Set site in astro.config.mjs to your real domain so canonical URLs, the sitemap and OG links are right.

Ship it as a native app

Aloha has no server and no external CDN, which is exactly what Capacitor wraps. The theme is already safe-area aware for notched iPhones.

pnpm build
pnpm add -D @capacitor/core @capacitor/cli
npx cap init "Your App" com.example.app --web-dir=dist
npx cap add ios && npx cap open ios

After each content change: pnpm build && npx cap sync.

Work with an AI agent

Open the folder in any coding agent that reads AGENTS.md, the repo's operating manual. It points at docs/conventions/, five convention files (astro, tailwind, typescript, motion, seo) each anchored to real files, at docs/design.md, the house design doctrine, what it refuses and what it does instead, and at wiki/, the architecture knowledge base with path:line citations. Ask for a new section and the agent builds it inside the design system instead of inventing its own.

Updates and support

Every release up to the next major version is included with your licence: you get an email with a fresh download link, and the changelog tells you what changed in plain language. Support is by email, contact@alohapixel.com, answered by the person who wrote the code.