Mindgrid Specification v1.0 -- Confidential
Sheet 1 of 1 -- Scale: 1:1
DWG-MG-001
Date:
Status: Production
Approved: ____
System Specification

The operating system for personal agents and applications

Build, host, and run apps and agents on your own data — without giving up control. Local-first, end-to-end encrypted, and self-hostable.

X: 0.000   Y: 0.000   Z: 1.000
REF: MG-HERO-001
LAYER: OVERVIEW
Section 01 REF: MG-OVERVIEW
What is Mindgrid?
Mindgrid is a cross-platform app that runs single-player applications and agents — called mapps — in a secure sandbox on your own machine. Mapps can connect to your services, work with AI, store persistent data, and even read and modify their own code.

Everything stays private. And everything syncs across your devices, with clients supported on desktop and mobile.
960px — max content width

Section 02 REF: MG-FEATURES
Detail A1 — Data Sovereignty

Your Data Never Leaves Your Control

  • Local-first: mapps and data live on your filesystem, not in the cloud
  • End-to-end encrypted sync — the server only sees ciphertext
  • Self-hostable: run your own sync server, or disconnect entirely
  • Open-source: audit every line of code
Detail A2 — Security Architecture

Defense-in-Depth Sandboxing

  • Four independent security layers: iframe sandbox, CSP, network filter, and local blocking proxy
  • Mapps get zero network access by default — every external request requires your explicit approval
  • API keys and tokens never reach the mapp — all authenticated requests execute outside the sandbox
  • Granular per-mapp, per-domain, per-endpoint permissions you control
Detail A3 — Integration Layer

Connect Everything, Expose Nothing

  • Plug in your own Google, Slack, Claude, OpenAI, and other accounts
  • Mapps call APIs through a secure proxy — they see responses, never credentials
  • Connect MCP servers and let mapps use tools without credential exposure
  • Declare permissions upfront or approve request-by-request
Detail A4 — Replication Engine

Sync Across Every Device

  • Each mapp gets its own SQLite database with CRDT-powered conflict-free replication
  • Settings, permissions, and mapp data sync automatically across desktop clients
  • Background worker mapps run persistently, with singleton coordination across your grid
  • Designate workers to run locally or on remote headless clients — automatic failover included

Section 03 REF: MG-PROCESS
How It Works
01

Build any static web app

Drop your HTML/CSS/JS build into a .mapp directory. No special SDK required. Your coding agent will do this for you.

INPUT PHASE
02

Run it in Mindgrid

Your mapp launches in a secure sandbox with its own database, file storage, API access, and the ability to modify its own code.

EXECUTION PHASE
03

Sync and publish

Connect to a grid and your mapps, data, and settings replicate across all your devices.

Mapp store coming soon to publish and share more widely.

DISTRIBUTION PHASE
3-step pipeline — no server required

Section 04 REF: MG-BUILDER-API
Built for Builders
B.01 — Compatibility

Any static web app (React, Vue, vanilla JS) becomes a mapp

B.02 — Bridge API

Bridge API for database access, file I/O, network requests, and service integrations

B.03 — Workers

Worker mapps for persistent background agents and automation

B.04 — MCP Support

MCP server support for connecting AI tools

B.05 — Self-Modification

Mapps have full read/write access to their own source — build agents that evolve, rewrite, and improve themselves autonomously

B.06 — WASM Runtime

Run compilers, bundlers, and AI models in-situ via WASM — mapps can build themselves without a server