thinkthroo

Complete project structure and file organization guide for the `apps/platform` Next.js workspace. Use when creating new files, adding features, placing API routes, defining database schemas, or deciding where any new code belongs. Triggers on questions about where to put files, how to name things, or how the platform codebase is organized.

API layer guide for the `apps/platform` workspace. Use when adding new API endpoints, creating tRPC routers, writing client services, or wiring up data fetching from stores or components. Triggers on any task involving API calls, tRPC procedures, server-side data access, or client-side service methods.

Error handling guide for the `apps/platform` workspace. Use when adding error boundaries, catching API/tRPC errors, showing error toasts, capturing exceptions with Sentry, logging with Pino, or wiring instrumentation. Triggers on any task involving error handling, error tracking, logging, or user-facing error feedback.

Performance guide for the `apps/platform` workspace. Use when optimising re-renders, splitting code, lazy-loading components or images, memoising expensive computations, deferring saves with debounce, or monitoring web vitals. Triggers on any task involving React performance, loading speed, bundle size, or rendering efficiency.

Security guide for the `apps/platform` workspace. Use when implementing authentication, protecting routes, guarding tRPC procedures, working with Supabase RLS policies, or using the service-role client. Triggers on any task involving auth, sessions, protected resources, row-level security, or token handling.

State management guide for the `apps/platform` workspace using Zustand. Use when creating new stores, adding state slices, writing store actions, selecting state in components, or wiring up data fetching from the API layer into global state. Triggers on any task involving Zustand stores, global state, store actions, selectors, or hooks that read from stores.

React component development guide for the `apps/platform` workspace. Use when creating new components, building UI, deciding where to place a component, styling with Tailwind, using @thinkthroo/ui primitives, or working with modals, forms, tables, and navigation. Triggers on any component creation or modification task.