Skip to content

AGENTS.md

Latest commit

 

History

History
66 lines (46 loc) · 1.79 KB

AGENTS.md

File metadata and controls

66 lines (46 loc) · 1.79 KB

OpenSpec Instructions

These instructions are for AI assistants working in this project.

Always open @/openspec/AGENTS.md when the request:

  • Mentions planning or proposals (words like proposal, spec, change, plan)
  • Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
  • Sounds ambiguous and you need the authoritative spec before coding

Use @/openspec/AGENTS.md to learn:

  • How to create and apply change proposals
  • Spec format and conventions
  • Project structure and guidelines

Keep this managed block so 'openspec update' can refresh the instructions.

Web App Agent Guide

Use this app for the main solana.com experience.

Identity

  • Workspace: apps/web
  • Package: solana-com
  • Default dev port: 3000
  • Public route ownership: /, /solutions, /developers, /ecosystem, /events, /news, plus other top-level marketing routes

First Files To Open

  1. package.json
  2. next.config.ts
  3. rewrites-redirects.mjs
  4. src/app/[locale]/
  5. content/ for guide-style content

Key Facts

  • Largest app in the monorepo and the usual integration point for the others
  • Next.js App Router with next-intl
  • Shared navigation and cross-app linking come from @solana-com/ui-chrome
  • A lot of behavior depends on rewrites-redirects.mjs
  • Vitest is used here for unit tests

Commands

pnpm --filter solana-com dev
pnpm --filter solana-com build
pnpm --filter solana-com lint
pnpm --filter solana-com test
pnpm --filter solana-com test:e2e

Gotchas

  • Route bugs may live in rewrites/redirects rather than the page component
  • Changes to shared chrome or locale routing often affect other apps too
  • This app owns the proxy layer that surfaces some separately deployed apps