mira-site

The Mira website, built with Mira. Served at https://mira.omrajguru.site.

The public build is a coming soon page. The full documentation is in content/docs/ and routes/docs/, marked draft: true: it shows in mira dev and is left out of mira build until launch.

Work on it

mira dev

Serves the site with live reload at http://localhost:4321, drafts included.

Publish

GitHub’s runners cannot build the site while Mira is private, so the built output is committed:

mira build

git add dist && git commit -m "Build" && git push

A push that changes dist/ runs .github/workflows/pages.yml, which publishes dist/ to GitHub Pages. It can also be run by hand from the Actions tab.

One time setup

1. Enable Pages. In the repository’s Settings, open Pages and set Source to GitHub Actions. Pages on a private repository needs a paid GitHub plan, and the published site is public.
2. Point the domain. Add a DNS record for mira.omrajguru.site: CNAME to omrajguru05.github.io.
3. Set the custom domain. In Settings, Pages, enter mira.omrajguru.site, wait for the DNS check, then turn on Enforce HTTPS.

To use another domain, change public/CNAME and site.url in mira.config.json, rebuild, and update steps 2 and 3.

Layout

Path	Contents
routes/index.mira	The landing page
routes/docs/	Docs routes (drafts)
content/docs/	Docs pages (drafts)
data/docs.json	Docs navigation
layouts/default.mira	Layout for docs pages
public/fonts/	Bricolage Grotesque, Geist, Geist Mono, Pixelify Sans (SIL Open Font License)
dist/	Build output, committed for Pages