fabro/CLAUDE.md
Bryan Helmkamp 5eaa653d1f Move OpenAPI spec from openapi/ into docs/api-reference/
Mintlify requires all referenced files under docs/, so consolidate to a
single copy and eliminate the symlink and the copy step in the generate
script.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 08:35:28 -05:00

693 B

Arc

Dev servers

  1. arc serve — starts the Rust API server (demo mode is per-request via X-Arc-Demo: 1 header)
  2. cd apps/arc-web && bun run dev — starts the React dev server

API workflow

The OpenAPI spec at docs/api-reference/arc-api.yaml is the source of truth for the arc-api HTTP interface.

  1. Edit docs/api-reference/arc-api.yaml
  2. cargo build -p arc-types — build.rs regenerates Rust types via typify
  3. Write/update handler in crates/arc-api/src/server.rs, add route to build_router()
  4. cargo test -p arc-api — conformance test catches spec/router drift
  5. cd packages/arc-api-client && bun run generate — regenerates TypeScript Axios client