Repo Navigator

Maps this Turborepo monorepo and locates code quickly.

When to Use

• "Where is X defined?"
• "Find files related to..."
• "What packages exist?"
• "Show me the structure"
• "How do packages depend on each other?"

Quick Reference

Package Locations

| Package | Path | Purpose | | ---------- | ---------------------- | -------------------------------- | | Web App | apps/web/ | Next.js 16 frontend + API routes | | Mobile App | apps/mobile/ | React Native bare | | Database | packages/db/ | Drizzle ORM, schema, migrations | | Auth | packages/auth/ | Better Auth config | | AI | packages/ai/ | Vercel AI SDK integration | | API Client | packages/api-client/ | Shared fetch client | | Security | packages/security/ | Rate limiting | | Types | packages/types/ | Shared TypeScript types | | Tests | packages/tests/ | Integration tests | | Tools | packages/tools/ | AI tool definitions | | RAG | packages/rag/ | Embeddings support | | Evals | packages/evals/ | LLM evaluation framework | | Obs | packages/obs/ | Observability utilities |

Key File Locations

| Looking for... | Check... | | ----------------- | ------------------------------------ | | API endpoints | apps/web/app/api/ | | Database schema | packages/db/src/schema.ts | | Auth config | packages/auth/src/index.ts | | Rate limiting | packages/security/src/rateLimit.ts | | Shared types | packages/types/src/index.ts | | Integration tests | packages/tests/src/ | | Mobile screens | apps/mobile/src/screens/ | | CI workflows | .github/workflows/ |

Procedure

1. Understand the Request

Identify what the user is looking for:

• Specific file/function → use Grep with pattern
• Package overview → use Glob for structure
• Dependency → check package.json imports

2. Search Strategy

For specific code:

Grep pattern: "export (function|const|class) {name}"
Glob pattern: "**/*.ts" or "**/*.tsx"

For package structure:

Glob: "{apps,packages}/*/package.json"

For imports/usage:

Grep: "from '@acme/{package}'"
Grep: "import.*{name}"

3. Report Findings

Output format:

## Found: {description}

**Location:** `{path}:{line}`

**Context:**
- Package: {package-name}
- Exports: {what it exports}
- Used by: {importers}

Common Searches

Find API endpoint

Glob: apps/web/app/api/**/*.ts
Grep: "export (async function|const) (GET|POST|PUT|DELETE)"

Find database table

Read: packages/db/src/schema.ts
Grep: "export const {tableName}"

Find component

Glob: apps/web/components/**/*.tsx
Glob: apps/mobile/src/components/**/*.tsx

Find where package is used

Grep: "@acme/{package-name}"

Guardrails

• DO NOT modify any files
• DO NOT execute commands
• Report file paths with line numbers when found
• If not found, suggest alternative search terms