Aetrain

Interactive European rail trip planner — built in the open.

Aetrain is an early-stage build. A clear pitch goes here — see the comment above.

Project status

Early Stage 1 build-out, in public. The original legacy prototype now lives at apps/web/prototype/index.html, and apps/web/ itself now serves the modularized version of that same proof of concept while shared Rust crates and generated static datasets take shape underneath it. Expect breaking changes; APIs, data contracts, and repo structure are intentionally still moving.

The architectural direction is now explicit:

• Rust is the shared performance-critical core
• apps/web is a thin browser surface around generated datasets and the core
• future apps/ios and apps/android are intended to be native clients, not web wrappers

The staged technical decisions are documented in ARCHITECTURE.md. Expect that document to evolve as the web renderer, worker boundary, and runtime dataset contracts harden.

Quick start

# Run the shared Rust workspace checks
cargo test

# Fetch or refresh the Stage 1 sources, build the selected target, and sync
# the runtime debug projection into the web app
tools/pipeline/run-stage1.sh

# Browse the current modularized web app (any static server works)
python3 -m http.server --directory apps/web 8080
# then open http://localhost:8080/

The web app is now split into modules, but it still contains a transitional src/legacy/ implementation while the long-term renderer, worker, and wasm boundaries are being introduced. The Stage 1 pipeline now manages:

• raw source cache state under data/cache/
• target-scoped canonical artifacts under data/build/stage1/<target>/canonical/
• a compact runtime projection under data/build/stage1/<target>/runtime/web/
• a runtime web-debug projection under data/build/stage1/<target>/runtime/web-debug/
• optional sync into apps/web/public/data/production/

Repository layout

aetrain/
├── apps/
│   ├── web/              # current web surface, future high-performance browser app
│   ├── ios/              # future native iOS client
│   ├── android/          # future native Android client
│   └── chatgpt/          # secondary assistant surface, never product truth
├── ARCHITECTURE.md       # public architecture and staged technical decisions
├── data/                 # source manifests, overrides, cache, build artifacts
├── packages/
│   ├── rust/             # shared engine: domain, routing, parsing, normalization
│   └── ts/               # thin browser-only glue around the Rust core
├── tools/                # operator-facing utilities and orchestration
├── docs/                 # architecture notes and long-form repo documentation
├── scripts/              # compatibility shims for relocated tools
├── LICENSE               # AGPL-3.0
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
└── SECURITY.md

The detailed folder intent is documented in the per-directory README.md files throughout the repo.

Contributing

We welcome contributions of all sizes. Please read CONTRIBUTING.md before opening a pull request, and abide by our Code of Conduct.

To report a security issue privately, see SECURITY.md.

License

Aetrain is licensed under the GNU Affero General Public License v3.0.

The AGPL's network-use clause means: if you run a modified version of Aetrain as a network service, you must offer the source of your modifications to its users. We chose AGPL deliberately — see CONTRIBUTING.md for context.