# Stashville

Stashville is a social city builder where developer work earns in-game currency. Integrations send activity events (commits, tool usage, sessions, agents) to the /api/events endpoint; the server turns those into coins, state transitions, and social signals.

## For LLMs building an integration

Read /llms-full.txt for the complete production API reference: auth, every event type, every required/optional metadata field, rate limits, error codes, and what NOT to send. It is the single source of truth for integrating with Stashville's production API.

## Links

- Full integration guide: https://stashville.vercel.app/llms-full.txt
- Human-readable docs: https://stashville.vercel.app/docs
- OpenAPI spec (auth-gated): https://stashville.vercel.app/api/integrations/openapi
- Get an API key: https://stashville.vercel.app/settings/integrations (requires a Stashville account)