Blueprints

Blueprints are JSON-defined room layouts you can create, share, and import. They define the 3D world layout, room configuration, props, and auto-assignment rules — all in a single portable file.

Blueprint Structure

{
  "id": "my-team:standard-dev",
  "name": "Standard Dev Team",
  "version": "1.0",
  "rooms": [
    {
      "id": "frontend",
      "name": "Frontend",
      "color": "#2F80FF",
      "props": ["desk", "monitor", "plant"],
      "autoAssign": { "pattern": "fe-*" }
    },
    {
      "id": "backend",
      "name": "Backend",
      "color": "#22C55E",
      "props": ["desk", "monitor", "coffee-machine"],
      "autoAssign": { "pattern": "be-*" }
    }
  ]
}

Creating a Blueprint

1. Set up your rooms how you want them in the UI
2. Go to Settings → Data → Export Blueprint
3. Download the JSON file
4. Share it with your team or save for future use

Importing a Blueprint

1. Go to Settings → Data → Import Blueprint
2. Paste JSON or upload the file
3. Preview the changes before applying
4. Click Apply Blueprint

Namespaced IDs

Blueprint IDs use a namespace:name format to avoid conflicts when sharing. Use your GitHub username or team name as the namespace.