project-guidelines-example

Standardize project guidelines by applying a reusable engineering playbook that documents architecture choices, repository layouts, and deterministic code patterns for Next.js and FastAPI. This ensures consistent implementation behaviors across your team without reinventing processes.

Enforce testing requirements by running pytest for backend unit tests, React Testing Library for component tests, and Playwright for end-to-end tests before deployment. These pre-deployment test and build gates ensure safer, consistent project changes.

Yes, you can use Supabase with a FastAPI and Next.js tech stack. The architecture overview documents Supabase as the intended database choice, ensuring new contributors can quickly align with the predefined integration patterns.

The best code patterns for validation-first error handling enforce input validation, data immutability, and strict operational hygiene like no console.log in production. These critical rules prevent runtime errors and maintain consistent API response contracts.

Structure your repository by following the recommended file layout that documents frontend and backend separation, API call helpers, and React hook patterns. Deployment workflow includes specific build steps and Cloud Run commands for operational consistency.