gi7b/mneme-super-app
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Unified Mneme app: world generator + 2D system map + 3D interstellar map in one PWA. Generates complete Cepheus Engine star systems, renders orbital maps, and visualizes interstellar sectors — all offline, all editable, all savable.
2 commits 1 branch 0 tags 54 KiB
  • TypeScript 71.7%
  • CSS 14.4%
  • Shell 6.8%
  • JavaScript 5.9%
  • HTML 1.2%
Find a file
Exact
Agent Kimi a4c227716d Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts
2026-05-08 01:01:46 +08:00
apps/shell Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00
packages Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00
scripts Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00
.gitignore Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00
package.json Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00
PLAN.md Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00
README.md Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00
tsconfig.json Initial commit: super app skeleton with PLAN.md, monorepo structure, @gi7b/core types/dice/physics, @gi7b/shell with React Router views (sector/system/generate/barycenter/settings), Forgejo Pages deploy script, and upstream sync scripts 2026-05-08 01:01:46 +08:00

README.md

Mneme Super App

One app to generate, visualize, and explore star systems for Cepheus Engine RPG.

PWA React Three.js License

Live: https://pages.gi7b.org/gi7b/mneme-super-app/
Forgejo: https://git.gi7b.org/gi7b/mneme-super-app

What This Is

The Mneme Super App unifies three previously separate tools into one seamless experience:

Tool What it does Package
Mneme CE World Generator Generates complete star systems with worlds, inhabitants, economies @gi7b/mwg
2D Star System Map Animated orbital view of any generated system @gi7b/map-2d
3D Interstellar Map 3D sector view of real (HYG) and procedurally generated stars @gi7b/map-3d

Unified Workflow

  1. Generate a 3D sector — procedurally or from real star data
  2. Click any star — auto-fill the world generator with its spectral type
  3. Generate the world — see its 2D orbital map instantly
  4. Multi-star systems — view in 3D with stars orbiting their barycenter
  5. Edit, save, export — everything in one place

Downloads

Platform Format
Linux .AppImage · .deb
Windows .msi
Android .apk

Quick Start

git clone ssh://git@192.168.196.76:223/gi7b/mneme-super-app.git
cd mneme-super-app
npm install
npm run dev

Open http://localhost:5173 — explore the sector view, generate a system, view its 2D map.

Architecture

See PLAN.md for the full architecture document.

packages/
├── core/          Shared types, dice engine, orbital physics, math
├── mwg/           World generator (React components, generator pipeline)
├── map-2d/        2D system map (HTML5 Canvas, orbital animation)
└── map-3d/        3D interstellar map (Three.js, HYG catalogue)
apps/
└── shell/         Unified app (React Router, Zustand state, Dexie DB)

Development

npm run dev          # Dev server (all packages)
npm run build        # Production build
npm run lint         # Lint all packages
npm run typecheck    # TypeScript check
npm run sync:all     # Pull latest from upstream repos

Sync Upstream

This repo auto-syncs improvements from three GitHub repos:

  • Game-in-the-Brain/Mneme-CE-World-Generator
  • Game-in-the-Brain/2d-star-system-map
  • Game-in-the-Brain/3d-interstellar-map
npm run sync:mwg     # Sync MWG core files
npm run sync:map-2d  # Sync 2D map core files
npm run sync:map-3d  # Sync 3D map core files

Built With

Based On

Mneme World Generator by Justin Cesar Aquino / Game in the Brain
Available on DriveThruRPG

Compatible with Cepheus Engine SRD and Traveller-family games.

Made by Game in the Brain