CONTRIBUTING.md

Contributing

One-line promise: Everything you need to contribute to the mcp-tool-shop marketing site.

Who it's for: Developers contributing to the site codebase. Not for: Tool authors wanting to list a tool (see Handbook), or press contacts (see Presskit Handbook).

---

Local development

cd site
npm install
npm run dev       # dev server on localhost:4321
npm run build     # production build to site/dist/
npm run preview   # preview production build

Project structure

site/
  src/
    data/         # JSON data files (projects, etc.)
    layouts/      # Astro layout components
    pages/        # File-based routing (*.astro)
    styles/       # Global CSS
  public/         # Static assets (favicon, images)

Deployment

Push to main triggers the GitHub Pages workflow automatically (filtered to site/** changes only). You can also trigger a deploy manually from the Actions tab.

Running tests

npm test                 # unit tests
npm run test:invariants  # cross-referential data integrity
npm run test:all         # both suites

All PRs must pass site-quality.yml checks: unit tests, invariant tests, schema validation, internal link check, and secret scan.

Useful links

• Handbook -- how the site works, common tasks, glossary
• Automation contract -- what automation owns vs. humans
• Security model -- sanitization rules and CI controls
• Trust Center -- verification infrastructure
• Presskit Handbook -- brand assets and press blurbs