A static, multi-project, Figma-style design canvas. Every board is an HTML file (or an image) placed on an infinite plane with pan, zoom, layers and selection.
Needs Python 3 and Chrome (or Chromium, Edge, Brave) for exports. No build, no dependencies.
git clone https://github.com/mattqdev/Atelier.git
cd Atelier
python3 atelier.py --install-launcher
That adds an Atelier app to your system (macOS: ~/Applications, Linux: applications menu, Windows: Start menu). Click it to start the local server and open the canvas. Then open the folder with Claude Code and ask it to design: it writes the boards, Atelier shows them live. No git? Download the zip of the latest release instead. On Windows use python instead of python3.
- Open: double-click
Atelier.html(works fromfile://, no server or build step). - Switch project: project menu in the top bar, or
Atelier.html?p=<id>. All projects in that menu opensprojects.html: every project as a card with a preview of its boards, counts, review status and when you last opened it. - Controls: drag/scroll to move · ⌘+scroll or pinch to zoom · double-click zooms to a board · Shift/⌘+click multi-select · ⌘A select all · ←/→ browse · Enter opens · Shift+1 fit all · Shift+2 fit selection · ⇧⌘E export ·
\layers. - Link to a board:
Atelier.html?p=<id>&b=<itemId>(the URL follows the selection). - Live reload: the manifest is re-read every 2 s; bump
revon an item to reload its board.
Open (or Enter) shows the selected board in view.html?p=<id>&b=<itemId>. The board always keeps its aspect ratio: it is shown at 100% and only shrinks when the window is smaller (in full screen it fills the screen).
From the viewer: previous/next (←/→), zoom (+/−, ⌘+scroll, drag to pan), Fit (Shift+1), actual size (Shift+0), background (B: canvas, white, dark, checkerboard), full screen (F), copy link, copy as PNG, open the original file, print / save as PDF (the PDF page matches the board size), export (⇧⌘E).
Like Figma: pick the boards (single, multiple, whole sections or everything) and one or more export settings:
| Setting | Values |
|---|---|
| Scale | 0.5x … 4x, or a target size: 512w (width), 1080h (height) |
| Suffix | appended to the file name; empty = @2x for scaled exports |
| Format | PNG, JPG, WEBP (with quality 1–100), PDF (vector, original size) |
| Transparent background | PNG and WEBP: no page background, for print files |
One file downloads as-is; several are bundled into <project>.zip. Settings are remembered.
Exports are rendered by headless Chrome, so they match the browser exactly. That needs the local server (Python 3, standard library only):
python3 atelier.py # http://localhost:4747/Atelier.html, opens the browser
python3 atelier.py --port 8000 --no-open
Chrome/Chromium/Edge/Brave are auto-detected; set ATELIER_CHROME=/path/to/chrome otherwise. Everything else keeps working from file:// without the server.
On the canvas each board is a small cached image (projects/<id>/.thumbs/); the real HTML loads only for the boards you zoom in on, so memory stays flat however big the project is. Served by atelier.py, thumbnails are rendered on demand. Opened from file://, render them once (Claude does it after editing boards); boards without one simply load live:
python3 atelier.py --thumbs NextWave # missing or outdated ones; no id = every project
python3 atelier.py --install-launcher
Creates an Atelier app bound to this folder: ~/Applications/Atelier.app on macOS (drag it to the Dock or open it from Spotlight), an applications-menu entry on Linux, a Start menu shortcut on Windows (pin it to the taskbar). One click starts the server in the background if it isn't running and opens Atelier in the browser. Run the command again if you move the folder. On macOS the server log is ~/Library/Logs/Atelier.log; stop the server with pkill -f atelier.py.
projects/index.js registry: window.ATELIER_PROJECTS = [{ id, name }]
projects/<id>/manifest.js project sections and boards (window.WORKSPACE); optional cover: "<itemId>" for the projects page card
projects/<id>/boards/ HTML boards
projects/<id>/assets/ css, logo, fonts
Projects are local and not versioned (projects/* is in .gitignore), except projects/example/. To create one: copy projects/example/, rename it, register it in projects/index.js. Without projects/index.js Atelier opens the example project.
Logo and launch assets live in docs/brand/: lockup.svg / lockup-white.svg, mark.svg / mark-white.svg, wordmark.svg, app-icon.svg (also app/atelier.svg, the favicon), PNG renders (app-icon-1024.png, lockup.png, lockup-dark.png), og-image.png (1200×630) and social-preview.png (1280×640, for the GitHub repository settings). Please don't redraw, recolour or retype the logo.
See CONTRIBUTING.md for the ground rules and how to open a PR, and CLAUDE.md for the structure, conventions (i18n, manifest fields) and how to verify changes.
Please read the Code of Conduct. Report security issues privately as described in SECURITY.md; questions and ideas go to Discussions.
MIT © 2026 MattQ


