entity-web

Marketing site + user docs for entity — a C++ media server for projection mapping.

Built with Astro + Starlight + Tailwind v4.

Local dev

npm install
npm run dev        # serves at http://localhost:4321
npm run build      # outputs to dist/
npm run preview    # serves the built site
npm run check      # astro check (TS, frontmatter, links)

Hosting

Deployed on Cloudflare (Workers static assets) at entitymedia.art. Every push to main triggers a build (npm run build) and deploy (npx wrangler deploy) through the Cloudflare Git integration; deploy config lives in wrangler.jsonc.

Project layout

src/
├── pages/                  Astro pages — marketing routes
│   ├── index.astro             /
│   ├── download.astro          /download/
│   └── community.astro         /community/
├── content/docs/docs/      Starlight docs — served under /docs/*
│   ├── getting-started/
│   ├── concepts/
│   ├── media/
│   ├── projection/
│   ├── control/
│   ├── reference/
│   └── troubleshooting/
├── components/             shared Astro components
├── assets/                 logos referenced from Starlight config
└── styles/
    └── global.css          design tokens + Starlight overrides
public/
├── brand/                  copied from the engine repo's images/
└── site.webmanifest

Brand assets

Copied from the engine repo (C:\Entity\Entity\images\). Re-sync if the brand evolves:

cp -r ../Entity/images/svg public/brand/
cp -r ../Entity/images/png public/brand/

License

MIT for site source code. Brand assets (under public/brand/) are licensed as in the engine repo.

Internal planning

docs-internal/ holds design notes that aren't user-facing (not served by Starlight). See PLAN-auth-and-licensing.md for how user accounts + Pro licensing will slot in.