Fauna Forum
← Cloomba for conferences

Deploying your site

The build is plain static files — any host that serves HTML works.

Build

yarn install
cp .env.example .env   # add your CLOOMBA_API_KEY
yarn build             # → apps/astro-theme/dist/

The build pulls your event's agenda, speakers, sponsors, and tickets from the Cloomba API and bakes them into static pages. dist/ is the whole site.

Hosting

Cloudflare Pages (what the demo runs on): connect the repository, set the build command toyarn build, the output directory to apps/astro-theme/dist, and add CLOOMBA_API_KEY as a build environment variable. Attach your custom domain in the Pages settings.

Railway or Netlify work identically (same command, same output path, same env var). GitHub Pages works with any static-deploy action. Or run yarn build locally and uploaddist/ to any web server — nothing about the site needs a runtime.

Keeping it fresh

  • Live by itself: the agenda's Now/Next strip and ticket availability refresh in the visitor's browser — a tier selling out shows without any rebuild.
  • Everything else (a new speaker, a session moved, edited copy) appears on the next build. Every host above has a deploy-hook URL — trigger it after editing your event, or put it on a schedule.

After the first deploy

  • Set site.url in the config to your real domain — it drives canonical tags, the sitemap, and the iCal link.
  • Submit /sitemap-index.xml in Google Search Console once.

Next: configuration · customization