GUNDAM / ABOUTV3.7.1 / 2026.11.16
ABOUT / THIS ARCHIVE

About GUNDAM Archive

A non-commercial fan research project. The goal is to turn scattered setting notes into something you can check, trace and keep building on.

VERSION 3.7.1DATA CUT 2026.11.16148 MS / 69 EVENTS
01 / THESIS

Why this exists

Gundam spans dozens of eras and works. The facts live in anime, setting books, model kit manuals and community wikis. Numbers disagree, timelines do not line up, and comparing one tech line can mean reading a dozen works. GUNDAM Archive puts that material into structured data.

02 / ARCHITECTURE

What is in the box

A static archive built with Next.js 15. All content lives in JSON under content/ and is checked by Zod at build time. The 3D viewer uses procedural reference assets. A glTF LOD0 can be wired in through the asset manifest without changing page code.

L1PresentationNext.js 15 App Router · static export · R3FShipped
L2ApplicationReact Server Components · build-time data loadingShipped
L3ServiceTarget: NestJS + Zod · currently replaced by build-time checksPlanned
L4Datacontent/*.json + Zod · target PostgreSQL 16 + JSONBShipped
L5AssetsProcedural LOD-P · target glTF 2.0 + KTX2 + CDNPartial
L6Operationsnpm run validate · GitHub Actions · content PR gateShipped
01

Content and code stay separate. Add a suit by adding a JSON file. No page edits.

02

One source of truth: src/lib/schema.ts defines both the data shape and the TypeScript types.

03

The build is the check. A bad schema, foreign key, lineage loop or one-way relation stops the release.

04

Three-language routes: /zh, /ja and /en, with an explicit fallback when a translation is missing.

03 / PIPELINE

Content pipeline

Adding a suit does not touch page code: drop in JSON, run the checks, rebuild.

01CONTENT

Add or edit an entry in content/*.json

02SCHEMA

Zod checks fields, foreign keys and references

03BUILD

Static export generates zh / ja / en pages

04SHIP

CDN / GitHub Pages, cache busted by hash

Single source of truth

src/lib/schema.ts defines both the data shape and the TypeScript types. Zod parses every file at build time, so a bad field, foreign key or lineage loop stops the build instead of shipping.

src/lib/schema.ts
04 / GOVERNANCE

Data rules

Sources are split into S/A/B/C tiers. Missing numbers stay blank. Values are never estimated from a similar suit. Disputed entries list both readings and carry a disputed flag. Every lineage edge needs a source. Events, people and tech entries need a long-form explanation. Public editing is closed; we take sourced correction drafts.

S
OfficialOfficial anime / setting books / official site
A
AuthoritativeAuthoritative reference / licensed publication
B
Community leadCommunity wiki, leads only
C
BackgroundBackground reading, never cited as data
05 / ROADMAP

Roadmap

This release is a working archive, not the final form. Next up: real glTF assets and a content service.

M0

M0 Foundation: repo, CI, design tokens, schema

DONE
M1

M1 One suit, end to end: 3D viewer, exploded view, quantum mode, dossier

DONE
M2

M2 Data skeleton: 12 suits, timeline, lineage, trilingual shell

DONE
M3

M3 Relations: people, factions, maps, search, motion system

WIP
M4

M4 Scale: 147 suits, global lineage graph, performance pass

NEXT
M5

M5 Launch: accessibility, mobile, SEO, monitoring, public beta

NEXT
06 / CONTRIBUTE

How to help

Corrections need a source and page number. For a new suit, read docs/CONTENT_GUIDE.md and run npm run validate before opening a PR. Code follows Conventional Commits.

GitHub Repository
Repository
  • docs/CHRONOLOGY.mdTwelve-era table and reading paths
  • docs/MACHINE_COVERAGE.mdSuit coverage and inclusion rules
  • docs/ARCHITECTURE.mdArchitecture and decision record
  • docs/CONTENT_GUIDE.mdHow to add a suit, event or character
  • docs/DATA_DICTIONARY.mdData dictionary and units
  • docs/ASSET_PIPELINE.mdglTF / LOD / manifest rules
  • docs/GOVERNANCE.mdSource tiers, disputes and copyright
07 / LICENSE

Copyright and licence

Code is MIT. Original text and charts are CC BY-NC-SA 4.0. Gundam and all related names and settings belong to Sotsu・Sunrise and Bandai Namco. This is an unofficial fan project. It uses no official artwork and is not sold.

Unofficial fan project. Not affiliated with Bandai Namco or Sotsu・Sunrise.

GUNDAM ARCHIVE / V3.7.1Home