# Development Guide

> Patterns for building features in the current Next.js Drizzle kit.

*Canonical: https://makerkit.dev/docs/nextjs-drizzle/development-guide/overview*

---

Use the development guide as a reference for the repo's normal flow:

1. define schema and validation
2. update database code if needed
3. add server actions or loaders
4. build UI components
5. wire the page

## Canonical Locations

- authenticated pages: `apps/web/app/[locale]/(internal)/...`
- public pages: `apps/web/app/[locale]/(public)/...`
- auth pages: `apps/web/app/[locale]/auth/...`
- local feature logic: `_lib/`
- local feature UI: `_components/`
- shared packages: `packages/**`

There is no dedicated `packages/features/` folder in this repo. If code becomes broadly shared, create a normal workspace package under `packages/` or one of the grouped package families.

## Topics

1. [Development Workflow](./development-workflow)
2. [Adding Features](./adding-features)
3. [Server Actions](./server-actions)
4. [Action Middleware](./action-middleware)
5. [Working with Forms](./working-with-forms)
6. [Database Operations](./database-operations)

---

**Next:** [Development Workflow →](./development-workflow)