CoolFace
Apppublic

btran299/pangaea-timeline

sourceHugging Facemitupdated 4mo agoView on Hugging Face
0likes
App README

Pangea Timeline

Interactive Pangaea / Earth-history timeline (CPSC 431). Register, log in, and manage your own stratigraphic log. Public exhibit works without an account.

This Space runs without MongoDB — data is stored in memory (DEMO_MODE=true). Restarts clear demo accounts and events.

Live app

Open the Space URL once the build finishes. You should see the exhibit and account forms at /.

Local development

bash
npm install
cp .env.example .env
# Edit .env: set MONGO_URI and DB_NAME for real MongoDB, or leave unset for demo mode
npm start

Open http://localhost:3000 (or the port in PORT).

VariablePurpose
PORTHTTP port (Hugging Face sets this automatically, often 7860)
HOSTBind address (default 0.0.0.0 in Docker)
DEMO_MODEtrue = in-memory DB; false = require MongoDB
MONGO_URIMongo connection string (local grading)
DB_NAMEDatabase name, e.g. cpsc431_lastnamefirstname

Docker (same image as this Space)

bash
docker build -t pangea-timeline .
docker run --rm -p 7860:7860 -e PORT=7860 -e DEMO_MODE=true pangea-timeline

Health check: GET /api/health → {"ok":true,"demoMode":true}

Course / MongoDB setup

For CPSC 431 grading with MongoDB, set DEMO_MODE=false, MONGO_URI, and DB_NAME in .env. WSL notes: see docs/MONGODB-WSL.md.