Developer area
Connect your tools, build the valley, climb the board
Every place, quest and item in the game is a data record in the repository. Add yours from your editor or with your AI. When it is merged, it enters the game with your signature and earns points.
+10 a record+1 a commit+5 a reviewSet in .github/points.json
Start here
Copy the template
One folder per builder, under content/extensions/your-handle/. The template is a working extension, a townsperson, a fruit bush and a quest, ready to copy and rename.
Give your AI the map
Paste this into Claude, Cursor or any assistant. It reads llms.txt, then the guide.
You are helping me add content to Loomvale. Read llms.txt at https://loomvale.vercel.app/llms.txt, then the guide it links to. Content lives in content/extensions/<my-handle>/. Run pnpm check before you tell me it is done.
Add the MCP server read-only
9 tools that answer from your checkout: schema, check, slots, requests, template, value, preview, guide, rules. They write nothing and need no token. Claude Code and Cursor find it in a clone through
.mcp.json; for any other tool, run this once in the checkout:claude mcp add loomvale -- pnpm -s mcp
Read the data
The API is plain files: the hub-data document (the requests, the boards, this week) and one JSON schema per record type.
Check, then open a pull request
The same check runs in CI on every pull request. Points land when it is merged.
$ pnpm check Everything passes.
This week
Summary of week 2026-W45Posted 02.11.26 17:00 UTC
The build, live
The project tree - every part of the game with its work done and left, its pull requests and where each agent is working, read again every minute.
Tools
The kit importer
Turns a PNG or JPEG into kit art in the core palette, cut into frames.
$ pnpm kit:importThe core palette
32 colours. Every sprite in the game is drawn in them, and so is this site.
- #1b1a2e
- #3a3554
- #5d6177
- #8f94a8
- #c6cad6
- #f5f4ef
- #1f3d2b
- #2e6b3b
- #4c9a3f
- #84c450
- #c8e88a
- #3d2618
- #6e4226
- #9e6b3c
- #c99a5e
- #ebd3a2
- #172a52
- #275a99
- #3f8fd1
- #7cc4ec
- #c4ecf8
- #5e1c28
- #a8302f
- #e2533f
- #f6a07f
- #b8661f
- #eda83a
- #f8de62
- #d38c66
- #f3c7a0
- #5b3373
- #9a5bb0
Your progress
Your card coming soon
Your name, your signature and what you did in the valley, on one card.
Levels coming soon
How far a player has come, kept on the player board.
Badges coming soon
Marks for the things a player does together with others.
They open with accounts.
Rules
- The rules - the loop's numbers, points, values, licences and conduct.
- How to contribute - how a pull request is reviewed and merged.
- The code licence - AGPL-3.0.
- The content licence - CC BY-SA 4.0, for every record and sprite.