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:
code
Grep pattern: "export (function|const|class) {name}"
Glob pattern: "**/*.ts" or "**/*.tsx"
For package structure:
code
Glob: "{apps,packages}/*/package.json"
For imports/usage:
code
Grep: "from '@acme/{package}'"
Grep: "import.*{name}"
3. Report Findings
Output format:
code
## Found: {description}
**Location:** `{path}:{line}`
**Context:**
- Package: {package-name}
- Exports: {what it exports}
- Used by: {importers}
Common Searches
Find API endpoint
code
Glob: apps/web/app/api/**/*.ts Grep: "export (async function|const) (GET|POST|PUT|DELETE)"
Find database table
code
Read: packages/db/src/schema.ts
Grep: "export const {tableName}"
Find component
code
Glob: apps/web/components/**/*.tsx Glob: apps/mobile/src/components/**/*.tsx
Find where package is used
code
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