gamecult-site/README.md

57 lines
1.7 KiB
Markdown
Raw Normal View History

2026-04-21 02:13:10 +01:00
# GameCult Site
`gamecult-site` is the public `gamecult.org` root site: studio pitch, projects, docs, blog, and the usual pile of ambitions trying to look organized in public.
2026-04-21 02:13:10 +01:00
The site builds against the shared `GameCult-Quartz` engine. This repo owns published content and the GameCult overlay.
2026-04-21 02:13:10 +01:00
## Repo Shape
2026-04-21 02:13:10 +01:00
- `GameCult/`: published Markdown content
- `site/`: GameCult-specific Quartz overlay
- `quartz.config.ts`
- `quartz.layout.ts`
- custom components
- custom styles in `site/quartz/styles/custom.scss`
- static assets
- `quartz-site/public/`: generated static output
- `scripts/quartz/quartz.ps1`: local build/dev launcher
- `.github/workflows/deploy-quartz.yml`: Pages deploy workflow, delegated to `GameCult-Quartz`
2026-04-21 02:13:10 +01:00
## Shared Engine Dependency
Local builds expect the shared engine repo to exist either:
- as a sibling checkout named `GameCult-Quartz`, or
- at the path provided through `GAMECULT_QUARTZ_ROOT`
Install dependencies in `GameCult-Quartz` first:
```powershell
cd ..\GameCult-Quartz
npm ci
```
2026-04-21 02:13:10 +01:00
## Local Development
From this repo root:
2026-04-21 02:13:10 +01:00
```powershell
.\scripts\quartz\quartz.ps1 dev
```
For a one-off production build:
```powershell
.\scripts\quartz\quartz.ps1 build
```
The shared engine stages a runtime under `.quartz-build/engine` and writes the final static site to `quartz-site/public`.
2026-04-21 02:13:10 +01:00
## Content Map
2026-04-21 02:13:10 +01:00
- `GameCult/index.md`: root landing page and manifesto
- `GameCult/Projects/`: public project pages
- `GameCult/Blog/`: posts, fiction, and announcements
- `GameCult/Docs/`: documentation and infrastructure-facing pages
2026-04-21 02:13:10 +01:00
`Aetheria` lives on its own site at `https://aetheria.gamecult.org`; this repo links outward instead of pretending to be both things at once.