Aetherium — Cinematic RSPS Website

A production-quality cinematic website for the Aetherium Old School RuneScape private server, built with Next.js, TypeScript, and Tailwind CSS.

Quick Start

pnpm install
pnpm fetch-assets   # Download OSRS Wiki assets
pnpm dev

Open http://localhost:3000.

Configuration

All server-specific values live in a single file:

src/config/server.ts

Update server name, URLs, progression rates, and legal text there. Never scatter these values across components.

Environment Variables

Copy .env.example to .env.local:

NEXT_PUBLIC_SERVER_API_URL=
NEXT_PUBLIC_USE_MOCK_DATA=true
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Asset Replacement

Assets are managed via scripts/fetch-assets.ts and documented in docs/ASSET_MANIFEST.md.

pnpm fetch-assets

To replace an asset:

1. Drop your file into the matching public/assets/ subdirectory
2. Update src/data/asset-manifest.json with the new path
3. Or add a new entry to ASSETS in scripts/fetch-assets.ts and re-run

Asset policy: Only real assets are used — OSRS Wiki downloads (attributed), original SVGs, or CC0 textures. No generic placeholders.

Project Structure

src/
  app/           # Next.js App Router pages
  components/    # UI components
  config/        # Central server config
  content/       # Structured content data
  data/          # Asset manifest (generated)
  lib/           # Utilities, API adapters, motion
  styles/        # Design tokens
docs/            # Planning and design documentation
public/assets/   # Downloaded and brand assets
scripts/         # Asset fetch script

Pages

Route	Description
/	Cinematic homepage (8 chapters)
/world	Interactive world map
/progression	Progression philosophy
/features	Feature showcase
/hiscores	Player rankings
/news	News hub
/play	Download and launch guide

API Integration

See docs/API_INTEGRATION.md. Set NEXT_PUBLIC_USE_MOCK_DATA=false and NEXT_PUBLIC_SERVER_API_URL to connect live endpoints.

Build & Deploy

pnpm build
pnpm start

Deploy to Vercel, Netlify, or any Node.js host supporting Next.js 15+.

Live site

https://aetherium-test-site.vercel.app

GitHub + Vercel (auto-deploy on push)

Repository: https://github.com/Superlapie/AetheriumTestSite

Vercel project: lapies-projects/aetherium-test-site

Every push to main automatically deploys to production. No manual steps needed.

Legal

Aetherium is an independent fan project not affiliated with Jagex Ltd. Game imagery © Jagex Ltd. Used under Jagex Fan Content Policy.