Synergism Forkd

A Rust rewrite of the TypeScript idle game Synergism. Forked, renamed, and ported one mechanic at a time.

⚠️ Status: rough, mid-conversion. This repo is an in-progress port from TypeScript to Rust. There is no playable build yet — most crates are scaffolding around a slowly-growing pile of ported game logic. APIs, save formats, and even the workspace layout are expected to churn until the port settles. The legacy TS sources are kept in legacy/ for reference; the Rust workspace under crates/ is where active work happens.

Layout

crates/
  synergismforkd_bignum/      # break-eternity-rs wrapper (Decimal)
  synergismforkd_common/      # shared types
  synergismforkd_logic/       # headless game logic
  synergismforkd_save/        # save format + migrations
  synergismforkd_ui/          # Dioxus components (platform-agnostic)
  synergismforkd_ui_web/      # WASM browser entry point
  synergismforkd_ui_desktop/  # Tauri shell (Win/Mac/Linux)
  synergismforkd_testkit/     # fixtures + sim runner + synergismforkd-sim CLI
assets/                       # translations, pictures, sounds
legacy/
  original/                   # frozen pre-split TS, reference only
  core_split/                 # current packages/ snapshot (TS), reference only

The legacy TS folders are not maintained — they live in the repo so the Rust port has the original source to reference while porting mechanics one by one.

Quickstart

Requires Rust stable (the toolchain is pinned in rust-toolchain.toml; rustup will auto-install).

cargo build --workspace
cargo test --workspace
cargo run -p synergismforkd_testkit --bin synergismforkd-sim

WASM browser build:

cargo build -p synergismforkd_ui_web --target wasm32-unknown-unknown

Status

Early, rough, in active conversion. Bare-bones scaffold — most crates ship a single placeholder function. The real work is porting mechanics from legacy/core_split/packages/logic/ into crates/synergismforkd_logic/ and standing up the Dioxus UI tree. Expect breakage: there is no stable save format, no playable build, and the workspace layout itself may shift as the port progresses. See docs/audits/STATE_AUDIT.md for the current state-slice porting punch list, and CLAUDE.md for crate boundary rules and porting guidance.

Contributing

See CONTRIBUTING.md.

Code of conduct

See CODE_OF_CONDUCT.md.

Security

To report a vulnerability, see SECURITY.md.