Landing page and documentation for the AI Context Protocol (ACP) specification.
Live site: https://acp-protocol.dev
This repository contains the website for the ACP Protocol, providing:
- Landing Page - Introduction to ACP Protocol and its benefits
- Documentation - Comprehensive guides and reference documentation (Diataxis-organized)
- Schema Hosting - JSON schemas for validation at
/schemas/v1/*.schema.json
acp-website/
├── acp-spec/ # Git submodule - specification & docs source
│ ├── acp-docs/ # User documentation (Diataxis)
│ ├── spec/ # Formal specification chapters
│ └── schemas/ # JSON schemas
├── apps/
│ └── web/ # Next.js 16 web application
│ ├── scripts/ # Build scripts (sync-docs.ts)
│ └── content/docs/ # Generated MDX (gitignored)
├── packages/
│ ├── ui/ # shadcn/ui component library
│ └── test-utils/ # Testing utilities
└── tooling/
├── eslint/ # ESLint configuration
├── prettier/ # Prettier configuration
├── tailwind/ # Tailwind CSS configuration
└── typescript/ # TypeScript configuration
Documentation is sourced from the acp-spec submodule and converted to MDX at build time:
- Source:
acp-spec/acp-docs/(Markdown, Diataxis-organized) - Conversion:
apps/web/scripts/sync-docs.tsruns during build - Output:
apps/web/content/docs/(MDX with frontmatter, gitignored)
The build also copies JSON schemas to public/schemas/v1/ for direct URL access.
| Layer | Technology | Purpose |
|---|---|---|
| Package Manager | pnpm | Monorepo management |
| Build System | Turborepo | Build orchestration and caching |
| Framework | Next.js 16 | React framework with App Router |
| Styling | Tailwind CSS 4 | Utility-first CSS |
| UI Components | shadcn/ui | Accessible, composable components |
| Type Safety | TypeScript 5 | Static type checking |
| Deployment | Vercel | Hosting and CI/CD |
- Node.js >= 22.0.0
- pnpm >= 10.24.0
# Clone the repository with submodules
git clone --recurse-submodules https://github.com/acp-protocol/acp-website.git
cd acp-website
# Install dependencies
pnpm install
# Start development server
pnpm devThe web application will be available at http://localhost:3000.
git submodule update --init --recursive| Command | Description |
|---|---|
pnpm dev |
Start development server |
pnpm build |
Build all packages (syncs docs first) |
pnpm sync-docs |
Manually sync docs from acp-spec |
pnpm typecheck |
Run TypeScript type checking |
pnpm lint |
Run ESLint |
pnpm format |
Format code with Prettier |
Documentation content lives in the acp-spec repository. To update:
- Make changes in
acp-spec/acp-docs/ - Commit and push changes in the submodule
- Update the submodule reference:
git add acp-spec && git commit - Push to trigger rebuild
The site deploys automatically to Vercel on push to main. The GitHub Actions workflow:
- Initializes submodules
- Runs TypeScript and lint checks
- Builds and deploys to Vercel
Preview deployments are created for pull requests.
- ACP Specification - The ACP Protocol specification and documentation source
MIT License - see LICENSE for details.