# AGENTS.md

Penpot: The open-source design platform for Product teams that need scalable collaboration.

## Setup

```
pnpm install
```

## Commands

```
# TODO: nothing declares a build or test command, so an agent has to guess.
# This is the single most valuable section of this file. Fill it in.
```

## Layout

- `frontend/`    1004 source files
- `plugins/`     222 source files
- `backend/`     214 source files
- `render-wasm/` 96 source files
- `mcp/`         47 source files
- `common/`      30 source files

## Conventions

- Tests live alongside the code they cover, following `backend/test/backend_tests/auth_oidc_test.clj`.
- CI defines what passing means. See `.github/workflows/auto-label.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `backend/resources/app/assets/swagger-ui-4.18.3.js` is 1021KB. It will not fit comfortably in context, so read it in parts.
- Copy `.env.example` before running anything that needs configuration.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.