how we ship code

The dev workflow

Every rule we follow to get a change from your machine into the project — branch, PR, review, merge. Read it top to bottom, like a git history.

Using an AI coding agent? Point it at /llms.txt and it'll follow these same rules.

  1. 285d29ccheckout

    Branch off devdev

    Never work directly on dev or main. Create your own branch from dev and name it user/yyyy-mm-xxxxx — for example pablo/2026-06-login-button. The date + a short description make it easy for everyone to know what you're working on.

  2. 29c716etest

    Build it and test it locally

    Run the project on your own machine and check that your change actually works before you go any further. Don't open a Pull Request for something you haven't tested locally (save rare exceptions). If it doesn't run for you, it won't run for anyone else.

  3. b63b57apush + PR

    Open a Pull Request to devdev

    When you're done, push your branch to GitHub and open a Pull Request (PR) targeting dev. A PR is just a request to merge your branch — it's where your work gets reviewed. (Some projects use main as their main branch instead of dev — check which one applies.)

  4. 4fc0658status

    Not ready yet? Mark it WIPWIP:

    If your PR is still a work in progress and shouldn't be merged yet, prefix the title with WIP: — e.g. WIP: Adding new login button to the dashboard — or mark the PR as Draft. That way reviewers know not to spend time on it, and definitely not to merge it.

  5. 6dec4afverify → notify

    Verify, then ping your reviewer

    Telling someone to review your work is the last step, not the first. Before you ping anyone, confirm all of this yourself:

    • The Pull Request was actually created
    • It targets the correct base branch (usually dev)
    • The build passes with no errors
    • The changed files and diff actually make sense — open the "Files changed" tab and read your own diff

    Only then, ping your reviewer on Discord and provide a link to the PR, so they know there's a PR waiting for them. This step is not optional — a PR nobody is told about just sits there unreviewed.