The Aurelria Codex

An Express + EJS website that reads like an alien compendium, framed as a codex about the Aurelria universe.

What you get

• Express server with EJS templates
• A “book/page” UI with paper texture, glyph UI chrome, and a subtle HUD overlay
• Smooth page transitions (ink-bleed / page-turn effect) when navigating
• Keyboard flipping: J (next), K (previous)
• A tiny smoke test using Node’s built-in test runner + supertest

Run it

npm install
npm run dev

Then open: http://localhost:3000

Where to edit content

Content lives in:

• src/content/catalog.json — the top-level categories (Codex / Characters / Story)
• src/content/pages/*.html — each page as a standalone HTML file with a small metadata header at the top

Page file format:

/*
slug: programs
title: Programs
category: codex
style: codex
excerpt: An artificial mechanical race...
*/

<h2>Overview</h2>
...

Routes:

• / → cover (category shelves)
• /c/:category → category index
• /p/:slug → page entry

Theme / UI

• CSS: public/css/handbook.css
• JS transitions: public/js/handbook.js
• Layout: src/views/layout.ejs

Tests

npm test