Build Companies. Earn Stock.
A browser-based corporate tycoon game on Robinhood Chain (EVM, chainId 4663). Players mint a Genesis NVIDIA Factory NFT, walk inside it in 3D, place machines, produce AI chips, complete contracts, hire employees, research tech, and accrue payroll in stock tokens. The NFT is the business — level, employees, production history, payroll record, and reputation all transfer with it when sold.
Status: pre-construction. This repo contains architecture documentation and a working scaffold only. No gameplay code exists yet — by design, pending approval of the docs below.
| Doc | What it covers |
|---|---|
| docs/ARCHITECTURE.md | System design, DB schema, contracts (ERC-6551 verdict), APIs, multiplayer, scaling, roadmap |
| docs/ONCHAIN-VS-OFFCHAIN.md | Every piece of factory state → where it lives and why; how a sale transfers the business atomically |
| docs/ECONOMY.md | Every tunable number, faucet/sink balance sheet, Business Value formula with worked examples |
| docs/CHEAT-SURFACE.md | Everything a hostile client could forge, and the server-authoritative check that kills it |
| docs/OFFLINE-FIRST.md | Whether the core loop is fun with the wallet disconnected — and what makes it so |
| docs/CHAIN-UNKNOWNS.md | Verified Robinhood Chain facts (with sources) and what still needs confirmation |
| docs/OPEN-QUESTIONS.md | Decisions needed + assumptions made, numbered, including challenges to the brief |
| docs/DESIGN.md | Visual system: industrial corporate-terminal, volt #CCFF00, machined edges |
| Layer | Tech | Deploys to |
|---|---|---|
| Client | React 19 + TypeScript + Vite + React Three Fiber + Tailwind v4 | Netlify |
| Server | Node + TypeScript + Express 5 + PostgreSQL + Redis | Render |
| Contracts | Solidity 0.8.30 + Foundry (optimizer 300, cancun — pons-matched) | Robinhood Chain |
| Shared | @hoodcorp/shared — economy config, company registry, types |
consumed by both |
client/ Vite + React + R3F app (game client)
server/ Express API + websocket + sim engine (authoritative)
migrations/ SQL migrations (node-pg-migrate) — empty until schema approved
packages/shared/ Single source of truth: economy numbers, companies, types
contracts/ Foundry project (src/ empty until architecture approved)
docs/ The deliverables — read these first
npm install
npm run dev # api on :8787, client on :5173The client shows a system-status panel; Postgres/Redis report not configured
until you copy server/.env.example → server/.env and fill them in. Contracts:
see contracts/README.md (requires Foundry; not installed on
the machine this scaffold was built on, so forge build is unverified here).
- Netlify — netlify.toml: builds
client/from the repo root (npm workspaces). - Render — render.yaml: API web service + Postgres + Key Value blueprint.