The big picture
One city in one box
A playful metaphor that still keeps the real engineering intact
Explain it like you're 5: Vault Voyage is a magic city in a lunchbox. It has a city hall, robot specialists with their own air traffic controller, a hospital, a library, a brain workshop that thinks without phoning anyone, a mapmaker who tracks every dot in 3D, a studio that turns photos into worlds, a port for sealed packages, and backup generators so the whole city keeps running even when the internet disappears. You can pick it up, set it down on any computer, and it still works.
Explain it like a builder: Vault Voyage is a unified platform that combines application server logic, authentication, database models, hardware integration, package management, workflow orchestration, offline documentation, AI tooling, medical interoperability, commerce, chat, XR, deployment tooling, and observability into one coherent system instead of dozens of loosely stitched services.
One city hall
There is one main brain that receives requests, checks badges, routes work, and sends answers back.
Specialists do specialist work
The main brain does not memorize every machine language. It delegates to specialists.
Packages teach new tricks
New capabilities arrive as sealed packages the city can verify, install, track, and export again.
How the city works in one glance
A website click, robot command, AI tool call, or outside integration request comes in.
Auth, sessions, SSO, OAuth, and roles decide what is allowed.
Hardware specialists, workflows, docs, AI, commerce, hospital, or XR services do the real work.
The UI can swap in only the changed piece instead of rebuilding the whole page.
District 1
City Hall / The Main Server
The center that receives requests, checks identity, routes work, and renders responses
The fast brain in the middle
Every time someone clicks a button, asks a question, or tells a robot to do something, the message comes here first.
The guard checks who you are. The clerk figures out where your message should go. Then the city sends back just the piece that changed -- like swapping one photo on a bulletin board instead of reprinting the whole board.
What the server really does
- Acts as the central request/response entry point for users, devices, AI assistants, and outside systems.
- Runs on a fast native engine instead of a heavy compatibility stack: no translation layers, no shims, less wasted motion.
- Uses partial page updates so the browser can swap in just the changed piece instead of reloading everything.
- Owns the full authentication stack: login, logout, sessions, single sign-on, OAuth, and role-based access control.
- Manages a database with 140+ record types including patients, cases, devices, orders, invoices, AI models, workflows, packages, 3D scenes, research evidence, and chat sessions.
- Uses a theme-aware, responsive component system that supports light mode, dark mode, phones, tablets, and desktops with semantic colors.
This gives the whole platform one coherent brain, one badge system, one UI language, and one shared data model instead of a pile of disconnected sub-apps.
District 2
BunBuddies
17 specialist workers so the main city does not have to speak every machine language itself
Seventeen translators for seventeen weird jobs
Imagine if one city had to talk to cameras, drones, robot arms, printers, hospital scanners, Bluetooth gadgets, and stage lights.
Instead of forcing City Hall to learn all those languages, Vault Voyage hires specialists. City Hall just says, "Camera helper, take a picture," or "Drone helper, fly here."
BunBuddy design principles
- 17 specialists total: 16 outward-facing device/service experts plus a shared toolkit foundation.
- Each specialist focuses on exactly one hardware or service domain instead of mixing responsibilities.
- Workers run independently, monitor their own health, and use circuit breakers so a failing one does not take down the rest.
- The shared toolkit provides common code and contracts so the specialists still behave consistently.
Tip: use the page search to find a specific specialist by name.
Basler / Camera Expert
Imaging
Kid version: The city's camera helper who knows how to tell industrial cameras when to snap a picture.
Builder version: Talks to industrial cameras and imagers, understands their protocols, and can capture images on command.
Bluetooth / Wireless Expert
Connectivity
Kid version: The helper who can find nearby gadgets and whisper to them without wires.
Builder version: Finds and communicates with Bluetooth Low Energy devices.
DimSum / Medical Imaging Expert
Medical
Kid version: The hospital picture keeper who knows the special language for X-rays and scans.
Builder version: Speaks DICOM, and can store, retrieve, query, and export medical images.
Drone / Drone Pilot
Robotics
Kid version: The flying helper who can tell drones where to go.
Builder version: Controls drones and UAVs across multiple flight protocols.
Gaussian / 3D Artist
Spatial
Kid version: The artist who turns lots of flat photos into a place you can walk around in.
Builder version: Builds explorable 3D scenes from photos, including gaussian splatting workflows.
Industrial / Factory Floor Expert
Machines
Kid version: The machine translator who talks to big factory tools and sensors.
Builder version: Speaks industrial and manufacturing protocols for machines and sensors.
IoT / Sensor Expert
Machines
Kid version: The tiny gadget helper who talks to small sensors and Arduino-style devices.
Builder version: Communicates with IoT hardware, environmental sensors, and microcontroller devices.
Lighting / Lighting Director
Machines
Kid version: The stage-light helper who knows how to make lights change color and brightness.
Builder version: Controls entertainment and studio lighting protocols.
Perception / Vision Expert
Imaging
Kid version: The helper who looks at what cameras see and figures out what's there.
Builder version: Processes camera data, identifies objects, understands 3D space, and works with robot operating systems.
Printer / Printer Expert
Machines
Kid version: The helper who tells label makers and printers exactly what to print.
Builder version: Runs barcode printers, receipt printers, and label makers.
Robotics / Robot Wrangler
Robotics
Kid version: The helper who guides robot arms and rolling robots so they move safely.
Builder version: Controls robot arms and mobile robots and plans their movements.
RPA / Software Robot
Automation
Kid version: The pretend office robot that clicks buttons and types in other software for you.
Builder version: Automates clicking, typing, and navigating existing software interfaces.
Scanner / Scanner Expert
Imaging
Kid version: The helper who reads papers, IDs, and forms into the city.
Builder version: Operates document scanners and ID readers.
ScoutDumpling / Web Scout
Research
Kid version: The explorer who goes out to learn things and bring notes back.
Builder version: Researches the web, collects pages, extracts content, and remembers what it learned.
USB / USB Expert
Connectivity
Kid version: The helper who notices when a gadget gets plugged in and learns how to talk to it.
Builder version: Detects and communicates with USB-connected devices.
Vision / Computer Vision Expert
Imaging
Kid version: The smart picture helper who uses deep learning to understand images and video.
Builder version: Runs deep learning vision models on images and video.
Shared Toolkit
Shared
Kid version: The common toolbox every helper borrows from so they all follow the same rules.
Builder version: Shared contracts, common code, and utilities used by the other BunBuddies.
Hardware becomes a first-class part of the platform. A drone, microscope camera, robot arm, barcode printer, and web research engine can all be orchestrated with the same server, auth model, workflows, and AI tooling.
District 3
Fleet Command
Coordinating many robots and drones at once
The air traffic controller
One robot helper is useful. But what if you need ten drones to search a field at the same time?
Fleet Command is the air traffic controller who tells each one where to go, watches for trouble, and calls for help if something goes wrong.
What Fleet Command does
- Swarm coordination: assign tasks to multiple drones or robots operating in parallel.
- Adapter management: each device type connects through its own adapter so Fleet Command speaks every dialect.
- Assignment preview: simulate a plan before committing it to real hardware.
- Incident alerting: detect faults and escalate automatically when a device stops responding.
- Works with drone-bunbuddy, robotics-bunbuddy, and any other device specialist.
Individual device helpers know how to talk to one machine. Fleet Command is the layer that turns a collection of helpers into a coordinated team.
District 3
Package Port
How the city learns new tricks safely, repeatably, and portably
The city's package harbor
New tricks arrive in sealed boxes. The city can check the seal, read the instructions, unpack them in the right order, and remember exactly what got installed.
Why this package system is unusual
- It does not only ship code libraries or containers; it ships entire capabilities.
- A .bao can deliver server plugins, database extensions, auth providers, workflow nodes, AI models, hardware drivers, 3D scenes, container images, configuration overlays, and more.
- The whole lifecycle is built in: convert, publish, install, lock, verify, and health-check.
A sealed lunchbox that teaches the city a new trick
A .bao is like a tamper-proof care package. When the city opens it, it learns a new job without guessing what was inside.
It comes with instructions, the real parts, and a seal that says, "Nobody messed with me."
What a .bao actually carries
- Manifest: what the package is, what it contains, what it depends on, and how to verify it.
- Payloads: code, configuration, models, schemas, assets, or whatever capability is being delivered.
- Integrity: cryptographic fingerprint, plus optional digital signatures.
- Breadth: 18 target kinds including server plugins, DB extensions, auth providers, workflow nodes, AI models, hardware drivers, 3D scenes, container images, and config patches.
- Portability: one package can carry platform-specific payloads for five platforms: two macOS variants, two Linux variants, and Windows.
The toy converter
BaoBun takes toys from other toy boxes and repacks them so this city can understand them.
It does not just copy them; it inspects them carefully, labels everything, and seals the package again.
BaoBun's 5 phases
- Ingest: download, unpack, and map the dependency tree.
- Analyze: classify modules, scripts, native add-ons, and post-install hooks.
- Map: convert what was found into the canonical .bao manifest shape.
- Generate: build the archive with multi-platform payloads plus provenance like license info and dependency graphs.
- Verify: validate integrity and correctness before publication.
Result: a sealed, verified .bao ready for the registry.
The warehouse shelf
Once a package is ready, it goes onto the city's shelf so everyone can find it later.
Think of it like a private app store that belongs to the city itself.
Registry behavior
- Stored by cryptographic fingerprint, so duplicates are naturally caught.
- Catalog can load into memory on startup for very fast lookups.
- Persists to the database so nothing disappears on restart.
- Supports search, browse, publish, and unpublish flows.
The delivery crew
Installing a package is like building a playground set. First you check the box, then read the instructions, then put pieces together in the right order, then make sure the swing actually swings.
7 installation steps
- 1. Check the seal: verify checksums and signatures against trust policies.
- 2. Validate instructions: confirm the manifest is well-formed and allowed.
- 3. Check dependencies / allowlist: confirm required packages are present and permitted.
- 4. Sort the order: use dependency ordering (topological sort: socks before shoes).
- 5. Run specialist adapters: each target kind has its own installer logic; there are 12 adapter specialists.
- 6. Update the receipt: write the exact install result to
.bao.lock. - 7. Health check: probe the new capability to confirm it is alive and responding.
District 4
StudyBun / The Recipe Kitchen
Manifest composition without hand-writing everything from scratch
A recipe book that can check its own homework
Instead of making you write every ingredient by hand, StudyBun lets you pick a recipe.
Then it can even send the scout out to double-check whether the recipe should be improved.
What StudyBun does
- Assembles complete validated .bao manifests from versioned recipe building blocks.
- Supports five presets: Full-stack, AI Lab, Automation, Research, and Custom.
- The custom path exposes a menu of 10 composable feature choices.
- Can run a self-improvement loop: ScoutDumpling researches docs, evidence is collected, improvement proposals are generated and applied, and the process can repeat up to 5 times.
- Available through a website configurator with real-time preview and through the command line.
Full-stack
AI, 3D, automation, docs, research, and device control.
AI Lab
Machine learning and AI-heavy capabilities.
Automation
Workflow orchestration and software robots.
Research
Web research and documentation tools.
Custom
Pick exactly the features you want.
StudyBun turns package creation from manual manifest writing into guided composition, and its research loop makes the package definition capable of getting better over time.
District 5
Translation & Export Bureau
How outside packages and codebases become native citizens, and how the city exports itself again
Anything in, anything out
If you hand the city a foreign toy, it can translate it. If you need to hand the city's abilities to someone else, it can print a matching instruction book.
The big idea
- Import path: packages come through BaoBun, codebases come through Dumplingify, old workspaces come through Baohaus migration.
- Export path: APIs become generated SDKs in 7 languages, and the whole platform can be emitted as one executable.
- The result is not a walled garden. It is a bidirectional adapter.
The universal code translator
If you bring the city an old machine built in a different language, Dumplingify rebuilds it so it fits the city's roads, badges, and rules.
It does not guess wildly. It follows a careful checklist.
Dumplingify in detail
- Ingest: clone the repo, inventory files, and research README/docs with ScoutDumpling.
- Analyze: detect languages, frameworks, routes, data models, auth patterns, UI pieces, tests, and dependencies. Detects 20+ programming and markup languages and dozens of frameworks.
- Map: deterministically choose Vault Voyage equivalents. Routes become server routes, DB models become schema definitions, UI pieces become server-rendered templates, auth patterns become native auth config. This phase is intentionally logic-driven and non-guessy.
- Generate: write server entry points, route plugins, schema additions, UI templates, API contracts, docs, config, and a checksummed .bao manifest.
- Verify: static analysis checks feature parity, schema parity, auth parity, UI parity, test parity, manifest validity, and artifact integrity. Blocking issues fail the pipeline.
Output: not a skeleton, but a validated, installable artifact.
Instruction books for every language
Once the city knows how to do something, it can print instruction books so other systems can talk to it in their own language.
Platform and BunBuddy SDK generation
- Platform SDK generator: creates type-safe client libraries from the main API contract in 7 languages.
- BunBuddy SDK generator: does the same for each outward-facing device/service specialist.
- Tiers: default, extended, and full generation modes.
- Engineering guarantees: concurrent builds, deterministic output, and CI drift detection so generated SDKs do not silently diverge from the API.
The whole city in one suitcase
Instead of hauling a truck full of parts, you can carry one suitcase, open it on another machine, and the whole city starts.
Standalone bundle
- Compiles the server into a single executable file.
- Needs no runtime, container engine, or extra dependency stack on the target machine.
- Useful for air-gapped environments, edge devices, labs, ships, field deployments, and any machine that can run a binary.
The moving crew for old neighborhoods
If there is an older version of the city, Baohaus helps decide what to keep, merge, fix, or throw away during the move.
Legacy migration
- Analyzes old workspaces package by package.
- Produces a disposition matrix: promote, merge, convert, or delete.
- Generates wave plans for staged migration.
- Outputs native .bao manifests with provenance tracking.
District 6
Knowledge District
Scout, library, and newspaper press for research, docs, and AI-readable knowledge
The scout, the librarian, and the printing press
One helper goes outside to gather facts, one helper keeps manuals on the shelf, and one helper turns writing into a beautiful guidebook that lives inside the city.
Why these three pieces matter together
- ScoutDumpling gathers knowledge from the web and stores memory locally.
- MLD turns documentation lookup into an offline local service with hybrid retrieval.
- Happydumpling turns docs into a first-class in-app experience that AI systems can parse structurally.
The field scout with a notebook
When the city needs to learn something from outside, it sends out ScoutDumpling.
The scout finds sources, reads them, cleans them up, remembers them, and can come back with a tidy little report.
What ScoutDumpling can do
- Discover: find relevant sources with search APIs.
- Collect: fetch content, including through a real browser when a page is interactive.
- Extract: clean messy pages into structured text.
- Remember: save findings in a local memory database with embeddings for semantic recall.
- Compose briefs: summarize what it learned.
- Run full jobs: orchestrate discover → collect → extract → brief end to end.
It acts as the research arm for StudyBun, Dumplingify, and AI assistants.
The offline library desk
MLD is like a librarian who already copied the manuals you need, so you do not have to run outside every time you forget how a tool works.
MLD's 4 phases
- Resolve: identify the library or framework. It has 29 pre-registered libraries (including Bun, Elysia, Prisma, HTMX, Tailwind, daisyUI, React, and more) in 5 curated packs.
- Collect: prefer machine-readable docs, otherwise crawl through ScoutDumpling.
- Index: split docs into overlapping chunks, build vector embeddings, store them in a local vector database.
- Query: combine semantic similarity with keyword matching, fused using Reciprocal Rank Fusion.
- Works offline once indexed.
- Auto-refreshes stale indexes older than 7 days.
- Deduplicates content by fingerprint.
- Acts as a self-hosted replacement for cloud doc lookup services.
The city's newspaper press
Happydumpling turns plain notes into a shiny, searchable newspaper that lives inside the city itself.
So the guidebook and the city always stay together.
Happydumpling's special features
- Native plugin: docs register routes directly in the main server. No separate hosting, iframe, or external docs app.
- 12-step compilation pipeline: discovery, frontmatter/metadata extraction, parsing, sanitization, math, diagrams, code highlighting, search extraction/indexing, sidebar building/layout, asset bundling with compression, manifest generation, and file writing.
- Rich presentation: diagrams, state machines, sequence diagrams, flowcharts, and publication-quality math.
- Search: fuzzy client-side search with debouncing, keyboard navigation, and accessibility.
- Interactive API explorer: browse endpoints, enter parameters, and send live requests from within the docs.
- Agentic manifest: generates
agentic-manifest.jsondescribing pages, routes, assets, integration endpoints, build metadata, page counts, ownership, and fingerprints so AI tools can understand the site without crawling. - Operations friendliness: ownership tracking, live integration monitoring, two docsets, offline service worker caching, and progressive enhancement.
District 7
Workflow Factory & Post Office
Orchestrating steps, persisting jobs, and making long work survive restarts
The conductor and the mailroom
BaoDown is the conductor deciding which instruments play first, together, or later.
bao-boss is the mailroom that makes sure long jobs do not get lost even if the lights flicker.
The split of responsibilities
- BaoDown: directed-graph workflow engine for multi-step operations.
- bao-boss: persistent job queue for long-running or retryable work.
Example workflow
BaoDown details
- Supports sequential and parallel execution in the same workflow graph.
- Node types include control flow, AI inference/training/classification, hardware commands, HTTP/webhooks, database operations, and software robot scripts.
- Triggers can be manual, cron-based, or external webhook events.
- Failures can retry with configurable backoff.
- Execution state is tracked in the database and progress can stream in real time over WebSockets.
bao-boss details
- Jobs survive restarts because they live in the database, not just memory.
- Uses database-level locking for safe multi-worker concurrency.
- Supports retries with backoff and optional jitter.
- Offers 120+ human-friendly cron aliases with timezone support.
- Includes dead letter queues, 4 concurrency policies, job dependencies, a real-time dashboard, and Prometheus-style metrics.
Together, workflows describe what should happen, and the job system guarantees that the heavy lifting still gets done reliably.
District 8
Speed Tubes & Inspection Office
Fast data transport plus strict shape checking
Fast tubes and shape checkers
Some messages are tiny whispers. Some are giant fire hoses. For the really fast ones, the city uses special speed tubes instead of writing long letters.
And before any data walks around town, inspectors check whether it has the right shape.
What lives here
- Wrapture: compact binary transport for high-frequency data paths.
- baobox: result-first validation library for internal shapes and route contracts.
- wonton: JSON Schema validator for configs and outside schemas.
Wrapture
- Built for fast-moving streams like drone telemetry, camera data, 3D meshes, workflow events, hardware state, training progress, and inference results.
- 20 specialized schemas.
- Zero-copy decoding and pooled builders reduce allocation and parsing overhead.
- Cross-language code generation keeps the main server and BunBuddies speaking the same binary language.
- Sampled metrics watch hot paths that can fire dozens of times per second.
baobox
- ~19,100 lines across 15 internal modules and 141 source files.
- Result-first API: returns success/failure instead of throwing exceptions as the main control flow.
- Portable validators can be precompiled and reused.
- Direct route-level integration with the web framework.
- 10 language packs for validation errors.
wonton
- Handles configuration files and external schemas.
- Uses the universal JSON Schema standard.
- Useful for validating deployment manifests and schemas from integrated systems.
District 9
Hospital Wing
Medical messaging and imaging without bolting hospital support on as an afterthought
The hospital translators
Hospitals speak some very old computer languages and some newer ones. Vault Voyage has helpers that understand both the old forms and the new forms, plus the picture vault where the scans live.
Core medical capabilities
- baofire-core: HL7 v2, MLLP, and FHIR R4 support for admissions, orders, results, patients, service requests, and diagnostic reports.
- DimSum: DICOM storage, retrieval, query, export, and viewer-oriented medical imaging workflows.
baofire-core
- Parses, builds, and validates HL7 v2 messages for admissions, orders, and results.
- Handles MLLP, the network framing protocol commonly used with HL7.
- Builds FHIR R4 Patient, ServiceRequest, and DiagnosticReport resources.
- Can generate deterministic anonymous patient IDs using a cryptographic hash when the source system does not provide one.
- Validates message profiles and trigger-specific required segments/fields.
DimSum
- Speaks DICOM, the universal format for medical imaging.
- Stores, retrieves, queries, and exports X-rays, CTs, MRIs, and similar scans.
- Supports archive workflows and downstream image viewer integration.
For hospitals and imaging-heavy environments, these capabilities are built into the city itself, not glued on later with brittle side integrations.
District 10
AI Embassy
The protocol layer that lets AI assistants discover tools, plus a built-in chat lounge that can use them
The embassy desk for robot helpers
If an AI assistant wants to help, it first goes to the embassy desk to see what tools the city has and what its badge allows.
Then the built-in chat lounge lets people talk to those tools in plain language.
What MCP gives the platform
- 14 tool providers exposed through the Model Context Protocol.
- AI assistants can control drones/robots, manage hardware, run workflows, query docs, install packages, do research, annotate documents, check health, and manage spatial experiences.
- Session management with 24-hour TTL and multi-instance support.
- Streaming updates over Server-Sent Events.
- Idempotent tool calls: the same request inside a short window can return the cached result.
- Resource subscriptions, role-based authorization, and context bundles.
What AI can do through MCP
Built-in AI chat
- Supports multiple AI providers, including cloud and local backends.
- Streams responses in real time.
- Keeps session history.
- Can use any of the MCP-exposed tool providers.
- Embeddable chat widget can live on any page.
District 12
The Brain Workshop
Local AI that thinks without phoning the cloud
Brains on a shelf
Some problems need a brain right here in the room, not a phone call to a faraway expert.
The Brain Workshop keeps trained brains on a shelf so the city can think fast without waiting for the internet. It can look at a picture and say what it sees, find the edges of things, or sort objects into groups -- all by itself.
What the Brain Workshop runs
- ONNX Runtime: portable model format for local inference, with optional hardware acceleration.
- Tasks: image classification, semantic segmentation, object detection, and feature extraction.
- Model caching: models are downloaded once and stored locally for offline reuse.
- Hub integration: search and pull models and datasets from the external model hub when connectivity is available.
- Metrics: inference latency and throughput tracked per model.
The AI Embassy lets outside helpers discover tools. The Brain Workshop is where the city does its own thinking -- on its own hardware, at its own speed, even when the internet is gone.
District 11
Operations District
Business operations, XR, offline mode, cluster rollout, and the utility tunnels underneath everything
Where everyday work happens
This is the part of the city where everyday work happens. The shops sell things and track orders. The backup generators keep everything running when the power goes out. And when the city outgrows one building, the construction crew builds a bigger one next door.
What is packed into this district
- Commerce and document lifecycles.
- XR / spatial computing features.
- Offline-first sync and local operation.
- Cluster deployment through Omnibao.
- Cross-cutting infrastructure like contracts, storage, observability, discovery, notifications, and utilities.
Commerce
- Sellers and vendors, with verification support.
- Shops belonging to sellers.
- Products with pricing, stock, shipping, tax, discounts, dimensions/weights, and SEO metadata.
- Work Orders lifecycle: draft → open → in progress → on hold → completed.
- Purchase Orders lifecycle: draft → submitted → approved → partially received → received.
- Invoices lifecycle: draft → sent → partially paid → paid / overdue / void.
- RFQs lifecycle: draft → sent → quoted → accepted, with conversion to purchase orders.
- Shared line-item model, soft deletes, API endpoints, and server-rendered web interfaces.
XR / spatial computing
- 3D asset management using industry-standard formats.
- Gaussian splatting from photos into explorable scenes.
- XR session tracking with multiple participants.
- Spatial anchoring and composition.
- Interaction logging and replay/event tracking.
Offline-first
- Local AI inference with cached models.
- Offline documentation through MLD and Happydumpling.
- Sync queue buffers changes when disconnected.
- Conflict resolution merges on reconnect.
- Audit trail / sync history is preserved.
- Local storage backends keep working when remote ones are unavailable.
- Single executable deployment supports air-gapped systems.
Omnibao
- Builds container images for every service.
- Generates deployment manifests.
- Manages local registries.
- Rolls out updates with safety gates or observation periods.
- Monitors and health-checks running instances.
- Validates configurations against best practices.
- Supports multi-architecture deployments.
Supporting infrastructure
- Eden Treaty: 40+ contract types to prevent server/SDK drift.
- Pluggable storage: object stores, distributed file systems, cloud blobs, or local disk.
- Observability: metrics, tracing, health endpoints, correlation IDs.
- Network discovery for local device detection.
- Notifications across email, webhooks, and in-app alerts.
- Railway MCP Bridge for remote development control.
- 146+ utility scripts for generation, validation, profiling, database management, hardware detection, and version sync.
This is where the platform stops looking like a simple app framework and starts looking like a full operational operating environment for hospitals, factories, labs, field sites, and businesses.
District 14
The Mapmaker's Tower
Coordinates, point clouds, and knowing where everything is
Drawing the ground so nobody gets lost
Before drones can fly or robots can walk, they need to know where they are.
The Mapmaker draws the ground, marks the landmarks, and keeps track of every tiny dot of every 3D scan so nothing gets lost in space.
What the Mapmaker handles
- Coordinate reference systems: translate between GPS, local grids, and indoor frames.
- Frame transforms: convert positions between different reference frames so a drone's view matches the map.
- Point clouds: store and manipulate millions of 3D data points from depth sensors and scanners.
- Spatial integration: feeds into the 3D Studio, gaussian splatting, and fleet coordination.
Every drone, robot, and 3D experience depends on precise location. The Mapmaker gives the rest of the city a shared sense of where things are.
District 15
The 3D Studio
Where flat pictures become places you can explore
Turning photos into worlds
The 3D Studio is where flat pictures become places you can walk around in.
You can pin notes to spots in mid-air, spin a model to see every angle, and turn a pile of photos into a whole room you can explore.
What the 3D Studio contains
- Media viewer: interactive viewer for pathology slides, 3D models, textures, and video assets.
- Asset formats: handles industry-standard 3D formats including GLB, GLTF, and video.
- Scene descriptions: supports universal scene description format for composable 3D worlds.
- Spatial anchors: pin annotations and measurements to precise coordinates, with parent-child relationships.
- Gaussian splatting: reconstruct explorable 3D scenes from a set of ordinary photographs.
Medical imaging, industrial inspection, and spatial computing all need interactive 3D. The Studio brings viewing, annotation, and reconstruction under one roof.
District 12
The Numbers
What the city is actually made of
Click a header to sort.
| What | Count | What it means |
|---|---|---|
| Database record types | 140 | Prisma schema models -- each one is a different kind of record the system can store |
| Service files | 531 | Backend logic files -- each handles one responsibility inside the server |
| API route plugins | 130+ | HTTP endpoints grouped by domain (ai, automation, core, devices, imaging, etc.) |
| HTML page routes | 41 | Server-rendered web pages for the browser UI |
| Device BunBuddies | 16+1 | 16 device-specific microservices + 1 shared toolkit |
| MCP tool providers | 14 | AI-accessible tool categories via Model Context Protocol |
| Package target kinds | 18 | Types of payload a .bao package can deliver (plugins, drivers, models, scenes...) |
| Install adapters | 12 | Specialist unpackers -- one per package target kind that needs custom install logic |
| Configuration files | 77+ | Config files across the monorepo (tsconfig, package.json, env, etc.) |
| Utility scripts | 146+ | Generation, validation, profiling, database, hardware detection, and version sync scripts |
| Binary transport schemas | 20 | FlatBuffers schemas for high-speed data (telemetry, 3D, sensor streams) |
| API contract types | 40+ | Eden Treaty contracts that catch server/SDK drift at compile time |
| Pre-indexed doc libraries | 29 | Libraries with offline docs ready to query (Bun, Elysia, Prisma, HTMX, Tailwind...) |
| SDK export languages | 7 | Generated client libraries: C#, Go, Java, Python, Rust, TS-Axios, TS-Fetch |
| Supported .bao platforms | 5 | macOS Intel, macOS ARM, Linux x64, Linux ARM, Windows |
| Test categories | 50+ | Distinct test suites across unit, integration, and contract testing |
| Detectable source languages | 20+ | Languages Dumplingify can analyze: TS, JS, Python, Go, Java, Rust, Ruby, PHP, and more |
| Validation error locales | 10 | Human languages for baobox error messages |
| Happydumpling source files | 57 | Files powering the built-in documentation compiler |
| Validation code lines | 19,100+ | Lines of validation logic in baobox (data shape-checking library) |
| StudyBun presets | 5 | Ready-made manifest recipes: Full-stack, AI Lab, Automation, Research, Custom |
| StudyBun composable features | 10 | Mix-and-match capability options for custom package manifests |
| Job queue concurrency policies | 4 | Rules for parallel job execution in bao-boss |
Vault Voyage is not a weekend project or a toy demo. It has 140 data models, 531 services, 14 AI tool providers, 20 binary-speed schemas, and 29 offline doc libraries -- the breadth and depth of a commercial operations platform, shipping as one system you can carry on a single laptop.
District 13
Why this matters
Why Vault Voyage is more than a pile of features
One city instead of thirty suburbs
Instead of buying 30 toy sets that barely snap together, you get one box where the pieces were made to fit.
Vault Voyage can replace 30–50 separate services for auth, storage, AI, workflows, docs, monitoring, queues, device management, and more with one deployment, one auth layer, one data model, and one codebase.
The .bao ecosystem is a new category
This is not just a box of Lego bricks or a delivery truck. It is both the box and the rules for how to add whole new rooms to the city.
.bao distributes complete capabilities — drivers, AI models, workflows, plugins, config patches, scenes, and more — with cryptographic trust, dependency resolution, and health checks.
Universal import and export
The city can invite outside toys in and can also send its own tricks out to other neighborhoods.
BaoBun, Dumplingify, and Baohaus bring things in; SDK generators and standalone bundling send capabilities back out to other systems and machines.
Hardware is a first-class citizen
Robots and cameras are treated like real citizens, not awkward guests.
BunBuddies, Wrapture, SDK generation, circuit breakers, and MCP exposure make devices as orchestratable as any API endpoint.
AI is the fabric, not a sticker
AI is stitched into the blanket, not taped on top.
ScoutDumpling, MLD, MCP, StudyBun, BaoDown, local model support, and Happydumpling's agentic manifest all make AI an architectural layer rather than a bolt-on feature.
The docs compile themselves and talk to AI
The guidebook is smart enough to explain itself to both people and robots.
Happydumpling is embedded in the app, avoids doc drift, and emits an agentic manifest that lets AI reason about structure, ownership, and integration surfaces.
Package composition can improve itself
The recipe book can go check a cookbook shelf and make itself better next time.
StudyBun's research loop feeds evidence back into manifest generation for up to five refinement cycles.
Offline without compromise
If the internet disappears, the city does not forget how to be a city.
Docs, AI, storage, sync, device control, and even deployment can work locally, including on air-gapped machines.
Binary speed where it matters
Fast messages go through a slide, not through the regular mail.
Wrapture brings zero-copy, pooled, cross-language binary transport to hot paths like telemetry, 3D data, and sensor streams.
One system for the next era
The hospital, toy store, robot lab, and spaceship room all live in the same city.
Medical imaging, robotics, drones, AI, business ops, XR, docs, workflows, and package management are integrated neighborhoods, not separate products from separate vendors.
Appendix
Glossary
Quick definitions in kid language and builder language
.bao
A sealed package that adds a new capability to Vault Voyage.
A package format carrying a manifest, payloads, integrity checks, optional signatures, and multi-platform artifacts across 18 target kinds.
BunBuddy
A specialist helper who knows one machine language really well.
An independently running device/service specialist with health monitoring and circuit breaking.
StudyBun
A recipe book that assembles the right package ingredients for you.
A manifest composer that builds validated .bao manifests from versioned recipes, presets, and optionally a 5-cycle research loop.
BaoBun
A converter that repacks outside packages so the city can use them.
A 5-phase package converter that ingests, analyzes, maps, generates, and verifies native .bao archives.
Dumplingify
A translator that turns foreign codebases into city-native ones.
A deterministic 5-step codebase conversion pipeline with parity checks and installable output.
ScoutDumpling / BaoBarian
A scout who goes out, learns things, and brings notes home.
A research service that can discover, collect, extract, remember, brief, and orchestrate full web research jobs.
MLD (My Little Dumpling)
The city's always-open library desk where you can look up how dozens of different tools work -- even when the internet is off.
A self-hosted offline documentation retrieval system with hybrid vector/keyword search and stale-index refresh.
Happydumpling
The printing press that turns notes into a nice newspaper.
A documentation compiler and native docs plugin with search, diagrams, API explorer, and an agentic manifest.
BaoDown
The conductor who decides what job happens first and what can happen together.
A workflow engine that executes directed graphs with retries, triggers, and real-time progress.
bao-boss
The post office that never loses a package.
A persistent job queue with retries, dependencies, cron aliases, and monitoring.
Wrapture
A speed-tube that sends camera pictures, drone flight data, and 3D shapes really fast by using quick codes instead of slow letters.
A compact binary transport with zero-copy decoding, pooled builders, and cross-language code generation.
baobox
The rule-checker that inspects every name, number, date, and ID to make sure nothing is the wrong shape before it gets saved.
A result-first validation system with portable validators, route integration, and 10 locales.
wonton
The customs officer who checks that packages from outside follow the city's rules before they're allowed in.
JSON Schema based validation for configurations and external schemas.
baofire-core
The hospital translator that understands old and new hospital languages.
Healthcare interoperability support for HL7 v2, MLLP, FHIR R4, deterministic patient IDs, and profile validation.
DimSum
The scan vault keeper who stores X-rays, CT scans, and MRIs so doctors can find and view them later.
Medical imaging support for DICOM storage, retrieval, query, export, and viewing workflows.
MCP
The embassy desk where AI helpers learn what tools exist and how to use them.
Model Context Protocol integration with 14 providers, sessions, streaming, idempotency, subscriptions, and roles.
Eden Treaty
A promise-checker that makes sure the city and everyone talking to it agree on the exact shape of every message, so nothing gets lost in translation.
A contract system with 40+ contract types that catches API/SDK drift.
Omnibao
The construction crew that copies the city onto bigger land -- building new rooms, moving furniture in, and making sure everything still works after the move.
Cluster deployment tooling for images, manifests, rollouts, registries, health checks, and config validation.
Agentic manifest
A treasure map that tells AI helpers exactly where every page, button, and guide lives inside the city, so they never have to wander around guessing.
The JSON structure Happydumpling generates to describe pages, routes, assets, integrations, build metadata, ownership, and fingerprints.
Topological sort
Putting socks on before shoes.
Dependency ordering so installations happen in the only safe sequence.
Circuit breaker
A safety fuse that cuts off one broken thing so the rest of the house stays on.
A resilience pattern that temporarily isolates failing services or device specialists.
ONNX
A brain that can think right here on your computer without phoning anyone.
Open Neural Network Exchange -- a portable model format for local inference with hardware acceleration.
Fleet
The air traffic controller for a team of robots or drones.
Multi-device swarm orchestration with assignment, monitoring, and incident response.
Point cloud
Millions of tiny dots that, together, look like a 3D picture.
A set of data points in 3D space, typically captured from depth sensors or scanners.
Spatial anchor
A sticky note pinned to a spot in mid-air that stays put even when you look away.
A persistent 3D coordinate reference point with parent-child relationships and measurement support.