Project structure and file organization guidelines
npx skills add https://github.com/elie222/inbox-zero --skill project-structureCopy and paste this command into Claude Code to install the skill
Guidelines for testing the application with Vitest, including unit tests, integration tests (emulator), AI tests, and eval suites for LLM features
Cursor Cloud VM setup and service startup instructions for local development
Simplify and refine recently modified code for clarity, consistency, and maintainability while preserving exact behavior. Use when asked to simplify, polish, refactor lightly, or clean up current-session changes before review or PR.
Commit changes and open a pull request with safe metadata
Review prompt and tool-description changes in a branch or PR. Use when asked to audit system prompts, prompt builders, tool descriptions, prompt inputs, or nearby evals/tests; summarize what changed; identify guidance that feels eval-shaped or too heavy for product use; and find repeated instructions between the main prompt and tool descriptions.
Add a new changelog entry to docs/changelog-entries/
| name | project-structure |
| description | Project structure and file organization guidelines |
apps/webpackages folderapps/web/utils/actions folder.
āāā apps
ā āāā web/ # Main Next.js application
ā ā āāā app/ # Next.js App Router
ā ā ā āāā (app)/ # Main application pages
ā ā ā ā āāā assistant/ # AI assistant feature
ā ā ā ā āāā reply-zero/ # Reply Zero feature
ā ā ā ā āāā settings/ # User settings
ā ā ā ā āāā setup/ # Main onboarding
ā ā ā ā āāā clean/ # Bulk email cleanup
ā ā ā ā āāā smart-categories/ # Smart sender categorization
ā ā ā ā āāā bulk-unsubscribe/ # Bulk unsubscribe
ā ā ā ā āāā stats/ # Email analytics
ā ā ā ā āāā mail/ # Email client (in beta)
ā ā ā ā āāā ... (other app routes)
ā ā ā āāā api/ # API Routes
ā ā ā ā āāā knowledge/ # Knowledge base API
ā ā ā ā āāā reply-tracker/ # Reply tracking
ā ā ā ā āāā clean/ # Cleanup API
ā ā ā ā āāā ai/ # AI features API
ā ā ā ā āāā user/ # User management
ā ā ā ā āāā google/ # Google integration
ā ā ā ā āāā auth/ # Authentication
ā ā ā ā āāā ... (other APIs)
ā ā ā āāā (landing)/ # Marketing/landing pages
ā ā ā āāā blog/ # Blog pages
ā ā ā āāā layout.tsx # Root layout
ā ā ā āāā ... (other app files)
ā ā āāā utils/ # Utility functions and helpers
ā ā ā āāā actions/ # Server actions
ā ā ā āāā ai/ # AI-related utilities
ā ā ā āāā llms/ # Language model utilities
ā ā ā āāā gmail/ # Gmail integration utilities
ā ā ā āāā redis/ # Redis utilities
ā ā ā āāā user/ # User-related utilities
ā ā ā āāā parse/ # Parsing utilities
ā ā ā āāā queue/ # Queue management
ā ā ā āāā error-messages/ # Error handling
ā ā ā āāā *.ts # Other utility files (auth, email, etc.)
ā ā āāā public/ # Static assets (images, fonts)
ā ā āāā prisma/ # Prisma schema and client
ā ā āāā styles/ # Global CSS styles
ā ā āāā providers/ # React Context providers
ā ā āāā hooks/ # Custom React hooks
ā ā āāā sanity/ # Sanity CMS integration
ā ā āāā __tests__/ # AI test files (Vitest)
ā ā āāā scripts/ # Utility scripts
ā ā āāā store/ # State management
ā ā āāā types/ # TypeScript type definitions
ā ā āāā next.config.mjs
ā ā āāā package.json
ā ā āāā ... (config files)
āāā packages
āāā tinybird/
āāā loops/
āāā resend/
āāā tinybird-ai-analytics/
āāā tsconfig/
api/hello-world/route)components/Button.tsx)components/uicomponents/components folderapps/web/app/(app)/PAGE_NAME/page.tsxpage.tsx or in the apps/web/app/(app)/PAGE_NAME folderswr for data fetching in deeply nested componentsonClick must be client components with use client directiveuse serverutils/ folder for reusable logicimport groupBy from "lodash/groupBy";