Public, reader-facing repository for the Entanglement of Ages book series.
Canonical repository: ryjen/entanglement-of-ages-marketing.
The public reader/discovery order is:
- The Fatherless — first novel
- Neurion — second novel
- Age of Embers — third novel
- The Age of Forms — fourth novel
This is reader order, not chronological order; the public reading guide distinguishes the two.
This repository contains only material intentionally approved for public release. Canonical manuscripts, drafts, story foundations, editorial notes, private publishing records, and unreleased creative assets do not belong here.
- Public website source, approved excerpts, approved artwork, press material, release information, and deployment configuration live here.
- Private authoring and canon development remain outside this repository in
ryjen/entanglement-of-ages. - This repository must build and deploy without access to any private repository, private token, or cross-repository secret.
- Public history must remain clean: do not mirror, subtree, or transplant private Git history.
- The public repository remains an independently reviewed derivative of the private series workspace; there is no automatic private-to-public synchronization.
Reader-facing routes and implementation identifiers use title-based book identities:
/books/the-fatherless/— Book 1/books/neurion/— Book 2/books/age-of-embers/— Book 3/books/age-of-forms/— Book 4
Retired relative-era compatibility routes are not part of the deployable public source.
The landing-page composition target is preserved in docs/site-concept-reference.md. The shared visual contract is documented in docs/visual-system.md. The Fatherless public-safe Institutional Eclipse direction is documented in docs/the-fatherless-visual-direction.md.
The site is static HTML/CSS with a manifest-authoritative publication boundary. JavaScript is the only custom scripting language.
- mise is the local/CI task front door.
- Node 24 runs publication, build, performance, deployment-diagnostic, and contract logic.
- Sharp owns responsive raster generation.
- Playwright owns browser smoke tests.
tools/site.mjsis the single project-tool command surface.
Run the complete local validation path:
mise run checkUseful narrower tasks:
mise run source
mise run contracts
mise run build
mise run validate
mise run browserGenerated output is written to dist/ and must be reproducible from committed public source files. See docs/visual-system.md for visual, accessibility, media, cache, and performance conventions.
CI validates every pull request and push to main. Successful main runs upload the validated dist/ artifact and deploy it through GitHub Pages using GitHub Actions as the only publishing source. The production custom domain is then probed through Cloudflare for origin identity, current assets, HTTPS, and edge behavior.
Pages must remain configured as Settings → Pages → Source: GitHub Actions. Do not switch to branch publishing; that bypasses the validated dist/ artifact. Cutover, verification, cache, and rollback procedures are documented in docs/deployment.md.
Repository code is covered by LICENSE. Story text, excerpts, artwork, logos, names, and other creative assets are governed separately by RIGHTS.md unless an individual asset states otherwise.