╔══════════════════════════════════════════════════════════╗
║ Your code powers humanity's journey to the stars. ║
╚══════════════════════════════════════════════════════════╝
| Component | URL | Status |
|---|---|---|
| Website | spaceorbust.com | Live |
| Dispatch App | spaceorbust.com/dispatch | Live |
| API | Railway | Live |
| Fire Dept Directory | 600+ departments | Live |
v1.1.0 - Multi-Transport Failover
- Production-grade transport manager ported from NightjarOS
- Internet transport with WebSocket + HTTP fallback
- LoRa mesh transport (Meshtastic protocol)
- GMRS radio transport (22 channels, gateway support)
- SMS gateway transport (Twilio-style API)
- Automatic failover with health monitoring
- Message priority routing (CRITICAL broadcasts to all channels)
Earlier Updates
- Railway API landing page - no more raw JSON at root URL
- Fire department directory - 600+ departments with dedicated pages
- French language support for Dispatch Protocol
- Space llama mascots with neon color variations
- Multi-language support (EN/ES/FR)
This is real software, not just a game.
Space Or Bust includes a production-ready dispatch system for fire departments and EMS - free, open-source, no vendor lock-in. The "game" layer gamifies open-source contribution, but the tools underneath are built to save lives.
A terminal-based RPG where your GitHub commits fuel civilization's expansion into space. Real orbital mechanics. Multi-transport sync. Kaizen hackathons that solve actual spacefaring challenges.
$ spaceorbust status
╔══════════════════════════════════════════════════════════╗
║ SPACEORBUST v1.1.0 | Year: 2024 | Era: Earth-Bound ║
╚══════════════════════════════════════════════════════════╝
RESOURCES
────────────────────────────────────────────────────────
Watts ⚡: [████████████████░░░░] 1,523⚡
Mass: [██████████░░░░░░░░░░] 847 kg
Data: [████░░░░░░░░░░░░░░░░] 256 TB
Population: 1.0B souls
FORGE CONNECTION
────────────────────────────────────────────────────────
✓ Connected: zjkramer (GitHub)
Last sync: 2024-12-18
Commits tracked: 127
$ spaceorbust mission plan leo mars_orbit
╔══════════════════════════════════════════════════════════╗
║ MISSION PROFILE ║
╚══════════════════════════════════════════════════════════╝
FROM: LEO
TO: MARS ORBIT
MANEUVER SEQUENCE:
─────────────────────────────────────────────────
1. Trans-Mars injection
Δv: 3.60 km/s | Cumulative: 3.60 km/s
2. Mars orbit insertion
Δv: 1.00 km/s | Cumulative: 4.60 km/s
─────────────────────────────────────────────────
TOTAL Δv REQUIRED: 4.60 km/s
─────────────────────────────────────────────────
PROPELLANT REQUIREMENTS (10000 kg payload):
Chemical (Methalox): 26,408 kg
Nuclear Thermal: 6,840 kg
Every watt of energy, every calorie counts in the void of space. This game reflects that reality:
- Watt (⚡) is the universal currency - energy is the true constraint
- Real physics - orbital mechanics match NASA values
- Multiple comms channels - sync via internet, LoRa mesh, ham radio, or QR codes
- Hackathons build real tech - challenges tied to the critical path of becoming spacefaring
# Install
npm install -g spaceorbust
# Or run from source
git clone https://github.com/zjkramer/spaceorbust.git
cd spaceorbust
npm install
npm run build
node dist/cli/index.js status
# Connect your GitHub
spaceorbust auth <github-token>
# Sync your contributions
spaceorbust sync
# Check your civilization
spaceorbust statusCORE:
status Show civilization status, resources, progress
sync Sync GitHub activity → collect resources
auth Connect GitHub/Gitea/Forgejo account
research View and complete tech tree research
MISSION OPS:
mission plan <from> <to> Calculate mission delta-v
mission hohmann <r1> <r2> Hohmann transfer calculator
mission fuel <dv> <isp> <kg> Propellant requirements
mission bodies Celestial body database
mission engines Engine reference (Isp values)
COMMUNICATIONS:
comms status Show transport status (TCP, LoRa, QR)
comms qr Generate QR code of your game state
comms text Human-readable state for manual sync
comms send Broadcast state via best transport
COMMUNITY:
hackathon View active kaizen challenges
hackathon info <id> Challenge details
guild Guild management (coming soon)
Your GitHub activity converts to game resources:
| Activity | Resource | Rate |
|---|---|---|
| Commits | Energy (⚡) | 10⚡ per commit |
| Merged PRs | Materials (kg) | 50 kg per PR |
| Issues closed | Data (TB) | 5 TB per issue |
| Code reviews | All | 3 each |
Based on NASA's actual technology roadmaps. Every dependency is physics.
Era 1: Earth-Bound (2024-2050)
- Reusable rockets, solar power, advanced materials
- Closed-loop life support, space medicine
- ISRU basics, additive manufacturing
- Milestone: Lunar landing
Era 2: Inner Solar (2050-2150)
- Lunar base, Mars transit, asteroid mining
- Fusion research, genetic adaptation
- Milestone: Self-sustaining Mars colony
Real challenges. Real solutions. Real prizes.
CURRENT CHALLENGES:
[BEGINNER] Expand the Lexicon
Add terms to the shared human-machine vocabulary
Rewards: 200⚡ + Lexicographer badge
[INTERMEDIATE] ECLSS Simulator
Build a closed-loop life support simulator
Rewards: 600⚡ + $25 merch credit
[INTERMEDIATE] Delta-V Calculator
Orbital mechanics from scratch
Rewards: 500⚡ + $25 merch credit
[ADVANCED] Meshtastic Integration
Sync game state over LoRa mesh
Rewards: 1000⚡ + Meshtastic device kit
[MOONSHOT] MOXIE Jr
Design/prototype CO2→O2 ISRU device
Rewards: 2000⚡ + $500 hardware budget
Internet down? No problem.
spaceorbust comms qr # Generate QR code (504 chars)
spaceorbust comms text # Human-readable format
# Output:
SOB/1.0/STATE/USER:ZJKRAMER/YEAR:2024/ERA:1/WATTS:1500/MASS:800/DATA:250
Sync via:
- Internet - TCP/WebSocket when available
- LoRa Mesh - Meshtastic devices, ~10km range
- Packet Radio - AX.25, requires ham license
- QR Code - Sneakernet, works anywhere
- NFC/USB - Tap-to-sync, offline transfer
A free, open-source CAD/dispatch system for fire departments and EMS. No vendor lock-in. No per-seat licensing. Forever.
Live Demo: spaceorbust.com/dispatch
Live API: spaceorbust-production.up.railway.app
- Web-based SaaS - Works in any browser, any device
- Offline-first - Keep dispatching when internet fails
- Multi-language - English & Spanish built-in
- ADA accessible - Screen readers, keyboard navigation, high contrast
- Real-time sync - Multiple dispatchers, WebSocket updates
- NFIRS export - Federal fire reporting compliance
- Multi-transport - Internet, Cellular, Starlink, LoRa mesh, Ham radio
# Docker (recommended for production)
docker-compose up -d
# Or run locally
cd src/server
npm install
npm run devWhen internet fails, the system cascades through available transports with automatic failover:
| Priority | Transport | Range | License Required | Status |
|---|---|---|---|---|
| 1 | Internet (WebSocket/HTTP) | Global | No | v1.1 |
| 2 | Starlink | Global | No | Planned |
| 3 | GMRS Radio | ~30km | FCC License ($35) | v1.1 |
| 4 | LoRa Mesh (Meshtastic) | ~10km | No | v1.1 |
| 5 | Ham/APRS | Unlimited | Yes (Technician) | v1.0 |
| 6 | SMS Gateway | Global | No | v1.1 |
| 7 | QR Sync | Sneakernet | No | v1.0 |
New in v1.1:
- Health monitoring with automatic channel selection
- Message priority routing (CRITICAL uses all channels)
- Exponential backoff retries with configurable limits
- Metrics tracking per channel (success rate, latency)
Real-time NWS data with fire danger indices:
- Fire Weather Index (FWI)
- Red Flag warnings
- Haines Index
- Burning Index
- Spread Component
src/
├── cli/ # Terminal interface
│ ├── index.ts # Command router
│ ├── display.ts # ASCII rendering
│ ├── mission.ts # Mission ops display
│ └── comms.ts # Communications CLI
├── core/ # Game logic
│ ├── types.ts # Core types
│ ├── state.ts # Persistence
│ ├── techtree.ts # Technology tree
│ ├── hackathon.ts # Kaizen system
│ └── guilds.ts # Guild mechanics
├── physics/ # Real physics
│ └── orbital.ts # Orbital mechanics
├── comms/ # Multi-transport (v1.1)
│ ├── protocol.ts # Message protocol
│ ├── manager.ts # Transport manager + failover
│ ├── transport.ts # Legacy transport layer
│ └── transports/ # v1.1 implementations
│ ├── internet.ts # WebSocket + HTTP
│ ├── lora.ts # Meshtastic mesh
│ ├── gmrs.ts # GMRS radio
│ └── sms.ts # SMS gateway
├── forge/ # Git forge integration
│ ├── github.ts # GitHub client
│ └── gitea.ts # Gitea/Forgejo client
├── server/ # Dispatch backend
│ ├── database.ts # SQLite offline-first
│ ├── auth.ts # JWT authentication
│ ├── websocket.ts # Real-time sync
│ ├── nfirs.ts # Federal reporting
│ └── api.ts # REST endpoints
├── dispatch/ # Dispatch core
│ └── core/ # Abstractions
└── web/ # Web applications
├── app/ # Dispatch frontend
│ ├── i18n.js # Translations
│ ├── connection.js # Multi-transport
│ ├── weather.js # NWS integration
│ ├── radio.js # Ham/APRS/LoRa
│ └── sw.js # Service worker
└── mascots/ # Llama graphics
Every PR advances the mission. See active hackathons for structured challenges, or:
- Fork the repo
- Create a branch
- Make your changes
- Submit PR
Your contributions become in-game resources. Meta.
Fund the mission. No pay-to-win.
Shop: spaceorbust.com/store
- T-shirts, hoodies, caps
- Space Or Bust branding with terminal aesthetic
- Achievement patches (requires unlocking)
- Contributor exclusives
100% of proceeds fund development. frack predatory private equity.
- GitHub: Issues, PRs, Discussions
- Reddit: Coming soon
- Meetups: Local hack nights, watch parties
No Discord. No Twitter. Signal over noise.
Code: MIT License - Because space belongs to everyone. And so should public safety software.
Brand: Space Or Bust™ and the llama mascots are trademarks of Flatland Expeditions LLC. See TRADEMARK.md for brand usage guidelines.
Free forever. frack predatory private equity.
"In the void, clear communication is survival."
- SpaceOrBust Lexicon
- Website: spaceorbust.com
- Dispatch Demo: spaceorbust.com/dispatch
- Store: spaceorbust.com/store
- GitHub: github.com/zjkramer/spaceorbust