# GridArchitect

> GridArchitect is a free web-based tool for Dungeons & Dragons Dungeon Masters to plan physical 3D terrain builds. Upload a battle map, overlay terrain tiles, and calculate exactly what you need.

## About

GridArchitect helps tabletop RPG players bridge the gap between digital battle maps and physical 3D terrain. It lets you upload any battle map image, calibrate a grid overlay, and then place terrain tiles from popular systems (Warlock Tiles, Dwarven Forge, Dungeon & Lasers) or your own custom tile sets. The app tracks your tile inventory in real time so you know exactly which pieces and how many you need to recreate the map physically.

## Features

- Upload and visualize high-resolution battle maps
- Create blank canvases for freeform terrain planning
- Calibrate grid size and offset to match any map's native grid
- Place tiles from any terrain system: floors, walls (inner/outer), corners, doors, windows, diagonal pieces, and custom shapes
- Configurable tile sizes (1x1, 2x2, and custom dimensions)
- Zoom, pan, and rotate tiles with intuitive mouse and keyboard controls
- Real-time tile inventory tracking with optional quantity limits
- Import and export tile configurations as JSON for backup and sharing
- Print-friendly cheat sheet of placed tiles for use at the table
- Fully client-side — no data leaves your browser
- Works on any modern browser, no installation required

## URL

https://gridarchitect.org

## Tech Stack

- React 19, TypeScript, Vite
- Konva / React-Konva for 2D canvas rendering
- Fully client-side single-page application

## Controls

- Left Click (Canvas): Place the selected tile
- Left Click (Toolbar): Select a tile type
- Drag (Canvas): Pan the map view
- Scroll Wheel: Zoom in/out
- R Key: Rotate the cursor tile 90 degrees
- Shift + Left Click: Remove a placed tile

## Supported Tile Systems

- Wizkids Warlock Tiles
- Dwarven Forge
- Dungeon & Lasers
- Any custom tile set (user-configurable names, sizes, colors, and shapes)

## Tile Types

- Floor tiles (rectangular, round quarter, diagonal)
- Outer wall tiles (straight, corners, round corners)
- Inner wall tiles (straight, corners)
- Doors and windows
- Props and custom shapes

## Documentation

- Full docs: https://gridarchitect.org/llms-full.txt