🗺️ builds.false.work Roadmap

Build distribution & playtest reporting system

🔨 In Progress

Phase 2: Playtest Reports

Structured feedback with fun categories for each build.

✓

Reports UI design

Tabs, report cards, detail view with 🍎🍟💭 sections
✓

Combined reports.mjs endpoint

GET/POST handler with respond() pattern, false.work-reports collection
✓

In-browser report submission form

Modal form with tester name, summary, and 🍎🍟💭 categories
✓

Report attribution display

Shows who submitted and when on build cards and report cards
○

Report editing

Edit existing reports after submission
○

Report soft-delete

deleted: true flag, hidden from UI but preserved in DB

✓ Complete

Phase 1: Core Build System

Automated builds, uploads, and password-protected distribution.

✓

Automated Windows/Mac builds via SSH

remote-update-and-build.fish triggers builds on remote machines
✓

DigitalOcean Spaces upload

Builds uploaded to assets.aesthetic.computer/false.work/
✓

MongoDB build registry

false.work-builds collection with platform, version, timestamps
✓

Password-protected builds.false.work

Netlify functions for auth + build list fetching
✓

Platform filtering & build tags

Quality presets (ultra, high, auto-detect), date grouping

📋 Planned

Phase 3: Manual Build Uploads

Allow authorized users to upload custom builds directly via the web.

○

Build upload form

Drag-drop .zip upload with progress indicator
○

Platform selector

Windows, Mac, iOS + custom platform support
○

Build metadata form

Version, description, tags, level/changelist
○

Direct-to-Spaces upload

Pre-signed URL upload, bypasses Netlify function limits
○

User attribution

Track who uploaded each build (tester name)

🔮 Future

Phase 4: Advanced Features

Nice-to-haves for a complete build management system.

○

Build diff viewer

Compare two builds, show what changed
○

Report export (PDF/Markdown)

Download formatted playtest reports
○

Discord webhook notifications

Ping channel when new builds or reports are added
○

Build retention/cleanup

Auto-archive old builds after N days
○

Multi-project support

Support projects beyond SpiderLily

🔮 Future

Phase 5: Steam Integration

Steamworks integration for beta distribution and branch management.

○

Steam depot/branch configuration

app_build.vdf templates for default, beta, playtest branches
○

SteamCMD upload automation

Script to upload builds to Steam after local build completes
○

Branch selector in UI

Choose target Steam branch (default, beta, playtest) when uploading
○

Steam build status tracking

Show Steam upload status and branch info on build cards
○

Set live branch from UI

Promote builds between branches (playtest → beta → default)
○

Steam playtest invites

Generate and track Steam playtest access codes

📐 System Architecture

┌─────────────────────────────────────────────────────────────────┐ │ builds.false.work │ ├─────────────────────────────────────────────────────────────────┤ │ [Builds Tab] [Reports Tab] [Upload Tab]* [Roadmap] │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌─────────┐ ┌──────────┐ ┌──────────┐ │ │ │ Build │ │ Report │ │ Upload │ │ │ │ Cards │ │ Cards │ │ Form │ │ │ │ + DL │ │ + View │ │ + Meta │ │ │ └────┬────┘ └────┬─────┘ └────┬─────┘ │ └───────┼────────────────┼─────────────────┼──────────────────────┘ │ │ │ ▼ ▼ ▼ ┌───────────────────────────────────────────────────────────────┐ │ Netlify Functions │ ├───────────────┬───────────────┬───────────────┬───────────────┤ │ get-builds │ get-report │ save-report │ upload-build* │ │ register-build│ list-reports* │ delete-report*│ presign-url* │ └───────┬───────┴───────┬───────┴───────┬───────┴───────┬───────┘ │ │ │ │ ▼ ▼ ▼ ▼ ┌───────────────────────────────────────────────────────────────┐ │ MongoDB │ ├─────────────────────────┬─────────────────────────────────────┤ │ false.work-builds │ false.work-reports │ │ ───────────────── │ ────────────────── │ │ platform, version │ buildPlatform, buildVersion │ │ timestamp, sizeMB │ tester, summary │ │ downloadUrl, tags │ lowHangingFruit[] │ │ level, ueVersion │ onTheSide[] │ │ uploadedBy* │ biggerThoughts[] │ │ description* │ deleted, createdAt │ └─────────────────────────┴─────────────────────────────────────┘ │ ▼ ┌───────────────────────────────────────────────────────────────┐ │ DigitalOcean Spaces (CDN) │ │ assets.aesthetic.computer/false.work/ │ │ spiderlily-windows-2025.12.15-1430.zip (builds) │ │ spiderlily-windows-2025.12.15-1430.txt (logs) │ └───────────────────────────────────────────────────────────────┘ * = Planned features

📦 MongoDB Collections

false.work-builds

Build artifacts & metadata

{
  platform: "windows",
  version: "2025.12.15-1430",
  timestamp: ISODate,
  sizeMB: 1342,
  downloadUrl: "https://...",
  logUrl: "https://...",
  tags: ["auto-detect"],
  level: "L_VerticalSlice_Demo",
  ueVersion: "UE_5.6",
  uploadedBy: "jeffrey",  // Phase 3
  description: "...",     // Phase 3
  createdAt: ISODate
}

false.work-reports

Playtest feedback

{
  buildPlatform: "windows",
  buildVersion: "2025.12.15-1430",
  tester: "Jeffrey",
  summary: "Quick playthrough...",
  lowHangingFruit: [
    { title: "...", desc: "..." }
  ],
  onTheSide: [...],
  biggerThoughts: [...],
  deleted: false,
  createdAt: ISODate,
  updatedAt: ISODate
}