# ModunOS — Public Build Log

> Literal product timeline for humans, crawlers, and site chrome.  
> **Status:** public beta · soft release · still densifying.  
> **Human page:** [modunos.com/build-log](https://modunos.com/build-log) · mirror [ai.modunos.com/build-log](https://ai.modunos.com/build-log)  
> **This file:** machine / cite source at `/build-log.md` on apex and `ai.`

---

## How to read this

| Marker | Meaning |
|--------|---------|
| **Milestone** | Notable platform transition (factual; no founder narrative) |
| **Release** | Shipped public / citizen-visible capability (compressed; no operator internals) |
| **~date** | Estimated when exact day is unknown |
| **YYYY-MM-DD** | Known sandboxed / public commit date |

**Insert rule:** date order under the right era. Short **Milestone** / **Release** heading, then 2–8 bullets. Never document ports, private hosts, credentials, bypass recipes, or reverse-engineering maps.

**Bake:** `node scripts/bake-build-log.js` — public page from this file; supporter Stage edition is separate.

---

## Era 0 · Foundations (2025)

### Milestone · Independent build start
**~early 2025**

- Solo development of web applications begins under Modun Systems (UK).
- Early output: many single-file HTML prototypes (single-thread AI-assisted chats) used to learn layout, state, and interaction patterns — not a borrowed product OS framework.
- Product direction forms toward a personal hub / OS-shaped environment (identity, spaces, media, tools) rather than one-off apps alone.
- Concentrated build arc from first prototypes to soft-release product faces is roughly **~8 months** of focused work (learning phase, then denser nights) inside this calendar year span.

### Milestone · Constrained development environment
**~2025**

- Early work proceeds on limited hardware and intermittent connectivity.
- Practice emphasis: ship small surfaces, keep a single evolving codebase.

### Milestone · Full-time build window
**~2025**

- Development time is concentrated on the ModunOS codebase ahead of general product revenue.

---

## Era 1 · Bench · single repository (~mid–late 2025)

### Milestone · Stable workbench
**~mid–late 2025**

- Move to a more stable power and workspace setup; longer sessions become viable.
- Development continues on a constrained laptop / Chromebook environment with a kiosk-style browser workflow and an empty starting filesystem.
- Handmade files and AI-assisted threads; surviving work consolidates into **one repository** that still underlies ModunOS.
- Early editor / space placement work — local, fragile, continuous.

### Milestone · Platform scope stated
**~mid–late 2025**

- Scope locks toward a personal hub / browser-native OS: identity, spaces, media hubs, optional assistants, clearer privacy defaults than commodity social feeds.
- Naming lines (ModunOS / Modunos / Modun Systems) harden later; product shape starts here.

### Milestone · Durable session requirement
**~late 2025 → early 2026**

- Primary bench moves to a stripped Linux install after noisier desktop experiments.
- Requirement established: session, storage, and host must outlive a single browser tab.
- Hardware failure workarounds used so the repository remains continuous.

### Milestone · Public edge
**~early–mid 2026**

- Same repository deployed behind a VPS origin and public TLS edge — visitable product hosts, not only local demos.
- Ahead OS / deep shell remains gated; public faces stay thin by design while the authenticated runtime densifies.
- Cadence: slow stretches, then concentrated leaps as shell and hubs densify.

---

## Era 2 · Substrate before version control (~2026-04 → 2026-05)

*Public sandbox git begins 2026-06. Dates below follow module / tree structure already in the product.*

### Release · Hub map and shell modules
**~2026-04**

- Module set taking shape: overlays, maintenance shields, toolbench, arcade stubs, streaming desk, early in-shell assistant surface, account overlay.
- **3D viewport** + **animator** (bones / timeline) as create-path primitives.
- **Zievu Forge**; **Operworld** client foundations for shared 3D spaces.
- **Radar**, **nexus-browser**, **operbox** messaging — presence and communication as first-class shell concerns.

### Release · Files, vault, explorer
**~2026-04 → 2026-05**

- **Explorer** and **Vault** for citizen / space assets.
- Network pulse and notification patterns — shell behaves as a live environment.

### Release · Security and network spine (public description)
**~2026-04 → 2026-06**

- Citizen sessions; role / tier awareness; operator surfaces kept off the public product.
- Realtime **presence**: who is where, invites, same-space chat.
- Multi-host direction: product faces and OS chrome share identity law (Account / Mail / OS).

---

## Era 3 · Versioned bench · chrome · auth (2026-06 → 2026-07)

### Release · Sandbox baseline
**2026-06-22**

- Versioned sandbox established. Checkpoints replace folklore as the progress record.

### Release · OS chrome densifies
**2026-06-28 → 2026-07-01**

- Header, dock, sidebar, side panels — continuous chrome refinement.
- In-shell assistant UI as a first-class surface.
- Sign-up / log-in modals — citizens enter as accounts.
- Display themes: light mode; later dream / zone accents.

### Release · Operlane profile · Connect
**2026-06-29 → 2026-07**

- Operlane profile revamp — publishable identity inside Connect.
- Hub dashboards for real zones: Home, Operlane, Operworld, Opervision, Lowcast, Marketplace, OS, Network / Modun Systems, Mission Control (dev).

### Release · Search and discovery inside the OS
**2026-07**

- Search providers + command-palette style discovery.
- Home dashboard refinement — discovery metrics and hub section kits.

### Release · Dynamic Nodes · Space Forge
**2026-07-07 → 2026-07-14**

- **Dynamic Node** overhaul: forged citizen spaces; widgets (people, comments, chat, friends, agents); media picker binding Operworld / Opervision.
- Live-stream widgets on nodes; iframe coupling to world instances.
- Space transitions, planet / dock chrome, mobile dock, OS Desktop space + window header stack.

### Release · Operworld · Opervision · streams
**2026-07-07 → 2026-07-11**

- Operworld matrix client + multiplayer sync; presence relay for 3D join/leave into OS social radar.
- Opervision player / studio; HD stream / broadcast path — Watch as a hub.
- Zone themes so hubs feel distinct inside one shell.

### Release · Social, radar, wiki
**2026-07-10 → 2026-07-11**

- Social panel + notifications — online presence and space ops.
- Dev radar overhaul — operator visibility into live citizens / spaces.
- Wiki / Codex path — citizen-facing living documents under the OS.

### Release · Electron shell
**~2026-07**

- Installable shell modes over the same cloud product (live / sandbox / stage / local).

### Release · Performance and header stack
**2026-07-14 → 2026-07-16**

- Performance passes; chrome transition fixes; OS system header / sim-bar refinements.

### Milestone · Planned pause
**2026-07-20 → 2026-08-25**

- Holiday planning packs; explicit don’t-break-live discipline.
- Return to a stable bench — continuity over heroics.

---

## Era 4 · Life apps · assistant routing (2026-08)

### Release · Health · Diet
**2026-08-29 → 2026-08-30**

- Health space + **Diet** planner: offline templates, household scaling, optional AI personalize, citizen persistence — guidance, not medical advice.
- App-window geometry; tier-aware AI assists (Plus / free-go) shared with Garage.

### Release · Garage · Vehicles
**2026-08-30**

- **Vehicles** bay sheets: plate-aware flow, DIY method sheets, assistant prefill / snap, citizen save.
- In-OS assistant **router** — routes to real spaces/apps, not only chat.

### Release · Marketplace / shop shells
**~2026-09-01 → 2026-09-02**

- Scheme-aware shop / marketplace shells (Garage / Health) — listings still densifying.
- Stripe-ready citizen checkout path for Plus / Creator tiers — soft-release monetisation.

### Release · Public AI surface plan
**2026-09-02**

- Public Void / ModunAI surface planned as the soft-release AI door (citizen-safe; separate from operator tooling).

---

## Era 5 · Soft release · public hosts (2026-09-01 → 2026-09-09)

### Release · About + ModunAI
**2026-09-03 → 2026-09-04**

- **modunos.com** — public About (*Your world. Your OS.*).
- **ai.modunos.com** — ModunAI (talk to Modun); `/void/` workspace path retained.
- Machine pack: `llms.txt`, identity yaml, robots, sitemap, build log.
- Framing: hub first / OS second; human first / AI assists; private on device · connected when you choose.
- Name lock: **ModunOS / Modunos** — not Modulus, Modus, Moduno, Modus Ponens.
- Privacy + Terms as honesty pages.

### Release · ModunAI craft (compressed)
**2026-09-04**

- Turn snap, reply rhythm, link confirmations, header chrome — public chat feel without exposing gateway internals.
- Secure cloud storage + single-environment wording at high level.

### Release · Landing polish · Works band
**2026-09-09**

- Landing frost / ambient / footer legal row; public contact **hello@modunos.com**.
- Modun Systems commissioned faces as a second money lane beside Product.

---

## Era 6 · Edge harden · constellation (2026-09-10 → 2026-09-20)

### Release · www and subdomain discipline
**2026-09-10**

- **www → apex** redirect as-built; unknown-host deny at the edge.
- Discovery smoke against real crawler UAs; pack stays fetchable on apex / `ai.` while gated hosts stay gated.

### Release · Modun Systems face
**2026-09-10**

- **modunsystems.modunos.com** — pricing floors, enquire intake, `systems@modunos.com`.
- Works: Link / Space / Constellation (+ Events Hosting).

### Release · Corner
**2026-09-10 → 2026-09-12**

- **corner.modunos.com** — fighters & gyms soft face: portal chrome, seat requests, own thin discovery.

### Release · Offgrid
**2026-09-12**

- **offgrid.modunos.com** — navigation / travel / field-life discovery face.

### Release · Brief (private)
**2026-09-12 → 2026-09-14**

- Access-gated Modun Brief for invited advisors — pack viewer, Ask dock, PDF pack, forms. Not a public crawl target.

### Release · ModunMAIL
**2026-09-13 → 2026-09-14**

- **mail.modunos.com** — hybrid ModunMAIL: `@modunos.com`, inbox/compose, drafts/thread actions, From display.
- Same citizen pass as the OS.

### Release · Modun Account + SSO
**2026-09-14 → 2026-09-20**

- **account.modunos.com** — identity dashboard: sign-in, minted accounts / `@handle`, cloud & mail doors.
- Google Sign-In; shared citizen session across product hosts; password change / session revoke.
- Cross-account identity bleed fixes — session law enforced in chrome.

### Release · Discovery pack Round 4
**2026-09-20**

- Pack enriched: Account, Mail, Systems Works, soft faces, Product/Works lanes, cloud OS platform / runtime wording for machines.
- Indexing policy: primary apex + `ai.` + pack; soft faces; never gated hosts.
- Public build log page ships; literal public timeline and supporter Stage edition separated.

### Release · ModunMESSENGER
**2026-09-20**

- **messenger.modunos.com** — friends and direct messages on the same citizen session as Account / Mail / AI.
- Native suite header and app tray (shared with other ModunOS product faces).
- Intimate messaging as its own door — not the full OS Home, not a public social network.

### Milestone · Product faces · shared identity
**2026-09-20**

- Live citizen doors on the constellation: landing, ModunAI, Account, Mail, Messenger — one identity, open out / merge back into the OS when you go deeper.
- Platform wording emphasizes personal hub and **runtime**, with dedicated product faces rather than one undifferentiated website.

### Release · Suite icons + shared app tray
**2026-09-21**

- T1 suite icon set exported to the public tree — product glyphs on dark plates for Mail, Messenger, AI, Account, and planned doors.
- Native product headers use **glyph-only** marks (full tiles stay in the app tray).
- Shared **Google-style 3-wide app tray** on native web faces: live hops for Home, Account, AI, Mail, Messenger; soon tiles for doors still cooking (OperVision, Sports, Finance, Offgrid).
- Apex asset routing for suite icons documented in ops (Caddy `/assets/*` on product hosts).

### Release · ModunGAMES door
**2026-09-22**

- **games.modunos.com** — Steam-class library face on the same citizen session as Account / Mail / Messenger / AI.
- Guest **Discover** is open (play without signing in); **Library** asks for Account and returns you to Games after sign-in.
- First playable first-party title (**Pulse**) plus honest soon stubs; Create points at the planned Zievu desk.
- Shared suite header, app tray, and constellation sign-out (one session across ModunOS product faces).

### Release · ModunGAMES library shelf
**2026-09-22**

- Signed-in **Library** syncs across devices — your titles, recent plays, and Pulse best score follow the account.
- **Pulse** deepened: levels, lives, pause/resume, clearer skill loop — still the one playable title (stubs stay honest soon).
- Discover stays guest-open; signed-in citizens get a **Continue** strip for last played.

### Release · Landing About copy
**2026-09-22**

- Apex lede tightened: spaces, apps, media, and cloud under one account — Opervision / Operworld sit in the Watch · play card, not the first breath.
- Inside cards: **Apps & tools** (broader than “life apps”); Home / Your data worded friendlier (account, not identity).

### Release · ModunOS master mark + favicon
**2026-09-22**

- Twin-peak **ModunOS** mark (`glyph-os`) on the apex header and as **Home** in the shared app tray — replaces the placeholder orb and the old Home PNG.
- Shared site favicon is the same master mark (was an empty file) — browser tabs and eventual search snippets pick it up after crawl refresh.

### Release · ModunGAMES in the OS
**2026-09-23**

- Home **Games** opens the same library experience as **games.modunos.com** — one shelf, one Discover, in the runtime and on the web door.
- Placeholder Games dashboard removed; cloud Library follows the citizen either way.

### Release · Zievu create desk
**2026-09-23**

- **create.modunos.com** — first branded constellation native create desk (**Zievu**), same citizen session as Account / Games / Mail.
- Guest **Home** desk intro is open; **Projects** ask for Account and return you to Create after sign-in.
- Honest rails: 2D project shelf on-device when signed in; Assets / Publish / 3D stay labeled Soon (no fake catalog publish).
- Shared suite header + app tray tile; Games **Create** CTA points at the live Zievu door.
- **Zievu** suite mark wired into chrome (glyph / tray) alongside the live constellation set.

### Release · Zievu projects cloud shelf
**2026-09-24**

- Signed-in **Projects** sync across devices — citizen VFS `/Create/projects.json` (same Garage / Games shelf pattern).
- Local cache + debounced cloud upsert; Guest Home stays open; Publish remains Soon.

### Release · Zievu 2D sketch loop
**2026-09-24**

- Open a project → calm sketch board (draw · undo · clear); strokes save into the project and sync with the cloud shelf.
- Honest make loop — no fake publish, no Unity pretence.

### Release · Guest mode · soft identity on product faces
**2026-09-24**

- **Guest mode** on guest-friendly hosts (including Create and Games): browse this face without using your cloud shelf; signed-in soft chrome shows who you are with a clear **Use my account here**.
- Shared header Guest badge and amended account panel across the constellation — Guest mode is not Log out.

### Release · Zievu guest sketch · claim on sign-in
**2026-09-24**

- Guests can sketch and keep packs **on this device**; sign in (or exit Guest) **claims** them into the citizen Projects shelf.
- Honest copy: device-only until you keep the work across devices.

### Release · ModunGAMES public Discover · Zievu publish
**2026-09-24**

- **Discover** lists first-party titles and **published Zievu** listings for everyone (including guests).
- Creators publish from Create into the public Games catalog; playable UGC may still ask for a Modun account.
- Publish is gated by **Zievu Creator** (soft release may accept ModunOS+ / Creator entitlement until dedicated checkout is live).

### Release · Zievu Echo · playable packs on Games
**2026-09-24**

- Published sketches with strokes ship a lightweight **Echo** pack — signed-in citizens can play them on ModunGAMES, not only see a Discover stub.
- Republish older listings to attach a pack when strokes exist.

### Release · ModunOS+ · Zievu Creator checkout · ModunPAY
**2026-09-24 → 2026-09-25**

- Citizen billing: **ModunOS+** (platform) and **Zievu Creator** (store publish path) on Stripe Checkout with GBP prices; return to the face you started from.
- **ModunOS+** covers linked accounts under one master (family pool); **Zievu Creator** is per account that upgrades for store publish.
- **account.modunos.com** Plan & billing shows what you have; Manage opens Customer Portal.
- **pay.modunos.com** — calm ModunOS billing door (portal return / plan context).
- **Zievu Online** (Take Online → future ModunWorld) exists as a product SKU; social live depth still ahead.

### Release · Linked accounts Switch on Create
**2026-09-25**

- Switching linked accounts from the tray on **create.modunos.com** sticks to the account you chose — shelf and publish entitlements follow the new session.

### Milestone · Create · Games · billing soft-release bridge
**2026-09-25**

- Soft-release loop closed enough to invite: make on Zievu → publish → Discover / Echo on Games → Creator checkout when needed — one citizen session across doors.
- Product destinations locked in vision: Creator → official Games store path; Online → ModunWorld social (not the Games catalog).
- First-party arcade depth beyond **Pulse**, and ModunWorld itself, remain open work.

### Release · ModunGAMES native 2D suite
**2026-09-27**

- First-party browser arcade collection expands beyond **Pulse** — additional Modun natives ship on Discover with shared local score helpers.
- Titles stay guest-friendly for play; signed-in citizens keep Library / shelf progress where the face already supports it.

### Release · Network presence across web faces
**2026-09-27**

- Signed-in citizens on **Games**, **Create (Zievu)**, **Messenger**, and **ModunAI** can appear together on the platform’s live presence view — web faces and the browser OS share one citizen identity without treating every page view as an OS session.
- Guest browsing and Guest mode stay off that map by default; leaving a face or signing out clears presence promptly.
- Operators can open the matching public face from a presence row when inspecting who is where.

### Release · ModunGAMES live Veil (two-player)
**2026-09-28**

- **Veil** on ModunGAMES gains a live two-player path for signed-in citizens — host a match or join a friend’s code; guests keep solo / same-device hotseat.
- Match chrome shows both `@names`, clear turn state, rematch ask/accept, and an opponent-left return to modes — without a public stranger lobby tab.
- Live match presence can surface on the constellation map as “in a match” without putting arcade ticks on the OS session pipe.

### Release · ModunGAMES find match · Discover join
**2026-09-28**

- Signed-in citizens can **Find a match** for Veil (willing pool) or **Join** when someone is already waiting — from the title flow and from a quiet strip on the Discover card.
- Web friends / invite / notification bell on Games (and shared constellation chrome) reuses the same citizen social graph as the OS — invite to play lands in the same live match plane.
- Match share-codes stay available as a fallback; there is still no public stranger lobby tab.

### Release · ModunGAMES next-wave natives
**2026-09-28**

- First-party shelf grows with **Connect**, **Flip**, **Dots**, and **Checkers** — each playable solo (vs Lucen), same-device hotseat, and live two-player where the title supports it.
- Shared craft language across the suite: seat colours, pause/end chrome, and Modun furniture so titles feel like one family, not bolted demos.

### Release · ModunGAMES 9-Ball
**2026-09-29**

- **9-Ball** joins the native suite — void table, spectrum solids, pull-back cue; play vs Lucen, hotseat, or live two-player on the same Games match plane as Veil / Connect.
- Table keeps true pool proportions on the web Games door and inside the ModunOS Games window — height-aware resize, no square stretch.
- Wide-table titles may later prompt landscape on very thin portrait screens rather than squash the playfield.

### Release · ModunGAMES live seats · invite wait · end chips
**2026-10-01**

- Live and vs-Lucen matches show **you** and **them** as fixed colour seats above the board — turn is visible on the active seat; piece/disc/box counts sit with each player instead of a separate “Turn” strip.
- Hosting after **Invite friend** waits on roster + Modes / Leave — no match-id share card in that path; join-with-code remains for people who still want a code.
- Round-end overlays use **Win / Loss / Draw** with quiet colour score chips (winner highlighted); seat-colour labels like “You · teal” are gone from those cards.

### Release · Zievu Create stage desk · playtest Shot
**2026-10-03**

- **Create (Zievu)** grows past stroke-only sketches: blank or Launch **stage** projects with Shapes / Draw / Playtest — place rects and circles, assign roles (wall, spawn, goal, enemy, trigger, deco), drag and resize on a soft grid.
- Playtest launches a **Shot** (aim Point or Pull back) with Soft / Normal / Snappy feel; walls can bounce, break, or pass; goals can score and respawn, swallow, or keep the shot rolling.
- Right-click menus stay target-aware (shape vs shot vs empty stage); studio cursors match the tool in hand.

### Release · Create / Games focus shell · soft routes
**2026-10-03**

- Opening a Create project or a Games title enters a quieter **focus** layout — side rail steps aside, stage fills, slim constellation header keeps Account / Guest reach.
- Soft URLs (`/p/…` on Create, `/play/…` on Games) so browser Back matches the on-screen back control; refresh can return to the same project or play session when entitled.
- Create and Games headers take on face teal so they feel native to those desks, not a second AI-blue sky.

### Release · Constellation mobile rails · header chrome
**2026-10-04**

- On phones and tablets, Create · Games · Mail · Messenger left rails open as drawers from the **brand mark**; the wordmark stays home. Desktop rails stay open as before.
- Shared constellation trays (apps · friends · notifications · account) open cleanly on narrow screens — top-snapped, touch-sized; account and notifications stay right-aligned with the account mark.
- Public home (unsigned): friends · notifications · account stay visible as a quiet peek — Sign in / Sign up when you use them; other spaces unchanged.
- Quieter headers where unused links were crowding the bar; unsigned mobile chrome keeps **Sign in** without a second Sign up control.

### Release · Apex OS home
**2026-10-07**

- **modunos.com** first viewport is a literal **OS home** — big ModunOS mark, search placeholder, suite app doors — instead of opening on a brochure pitch.
- Live doors (AI · Games · Zievu · Mail · Messenger · Account) open straight in; soon doors (Connect · OperVision) show a quiet tip before you leave.
- About stays below: *Your world. Your OS.* (accent on world / OS), the prior lede and CTAs, and the privacy / connected line — Home ↔ About pager soft-scrolls between them.
- Shared header and app tray are unchanged; full OS session remains the downloadable / `app.` path when that ships.

### Release · ModunWorld opens (`connect.`)
**2026-10-09**

- **ModunWorld** ships on **connect.modunos.com** — the public social hub for ModunOS (profile, feed, groups), separate from Messenger DMs and the Games shelf.
- Home is open signed out or in; Profile holds display name, bio, photo, banner, and what you choose to show from Create, Games, and Worlds.
- Public faces resolve at `/u/handle`; the shared constellation header can open your ModunWorld face and change photo from the account panel.
- New accounts can land on a short face setup after sign-up, then continue to Games, Zievu, or wherever they came from.

### Release · ModunWorld Groups
**2026-10-09**

- **Groups** on ModunWorld: create or join rooms with text channels — hang while you play or make, without turning Messenger into a second Discord.
- Inside Groups, a quiet server stack and channel list sit beside the chat room; members stay visible when you need them.
- Discoverable groups can appear for others to join; private DMs remain on Messenger.

### Release · Face Media Maker
**2026-10-10**

- Profile photo and banner on ModunWorld open a shared **Face Media** maker: upload your own, pick a curated Modun mark, or describe one to generate.
- Stock marks work without AI; AI Make uses the same Google path as Council when available, with a door ready for on-machine / RunPod models later.
- The same maker is meant for studio marks on Zievu and player looks in Operworld — one face path across the constellation.

### Milestone · Soft release ongoing
**2026-09 (ongoing)**

- Base environment public enough to invite strangers; density and paid loops remain open work.
- Product and Works revenue still early; constellation positioned to earn.
- Field / Offgrid node intent remains on the roadmap (movable control centre).
- Soft faces now include apex OS home, Games natives, Zievu Create stage, and **ModunWorld** (`connect.`) with profile, Groups, and Face Media; next is owner priority — Lucen/search on home, deeper Groups/Feed, Create refine, Payment, or further titles — not a missing pipe.

---

## Operator-only (never on this page)

Ahead-of-live benches, promote recipes, Access allow-lists, and operator tooling stay private.

---

## Template for the next entry

```markdown
### Milestone · Short title
**~YYYY-MM** or **YYYY-MM-DD**

- Bullet…

### Release · Short title
**YYYY-MM-DD**

- Public / citizen-visible change…
```

---

*Maintainer: edit this Markdown for the **public** log, then run `node scripts/bake-build-log.js`. Supporter narrative stays in `public/ai/build-log/stage.md`. Never add ports, credentials, or bypass recipes.*