This document provides essential context about the Intercode codebase for AI assistants working on the project. See the agent-docs/ directory for detailed topic guides.
Intercode is a convention management system built with:
- Backend: Ruby on Rails with GraphQL API
- Frontend: React with TypeScript
- Routing: React Router v7
- Data Fetching: Apollo Client for GraphQL
- Styling: Bootstrap 5
- Build Tool: Vite
- Apollo Client Usage Patterns — How to access the Apollo Client in loaders, actions, and components; common mistakes and errors
- Frontend Patterns — File organization, React Router, GraphQL, forms, modals, i18n, auth, utilities
- Testing — Minitest considerations, Playwright end-to-end tests
- Development — Build commands, PR labels, tips
- TypeScript: Run
yarn run tsc --noEmitafter making changes - Ruby: Run the relevant test suite before committing