cfa137795b
* refactor: consolidate AGENTS.md and CLAUDE.md files, update tech stack and architecture details - Merged content from CLAUDE.md into AGENTS.md for better organization. - Updated tech stack section to reflect the current technologies used, including Next.js, Supabase, and Tailwind CSS. - Enhanced monorepo structure documentation with detailed directory purposes. - Streamlined multi-tenant architecture explanation and essential commands. - Added key patterns for naming conventions and server actions. - Removed outdated agent files related to Playwright and PostgreSQL, ensuring a cleaner codebase. - Bumped version to 2.23.7 to reflect changes.
1.3 KiB
1.3 KiB
Next.js Utilities
Quick Reference
| Function | Import | Purpose |
|---|---|---|
enhanceAction |
@kit/next/actions |
Server actions with auth + validation |
enhanceRouteHandler |
@kit/next/routes |
API routes with auth + validation |
Guidelines
- Server Actions for mutations only, not data-fetching
- Keep actions light - move business logic to services
- Authorization via RLS, not application code
- Use
'use server'at top of file - Always validate with Zod schema
Skills
For detailed implementation patterns:
/server-action-builder- Complete server action workflow
Server Action Pattern
'use server';
import { enhanceAction } from '@kit/next/actions';
export const myAction = enhanceAction(
async function (data, user) {
// data: validated, user: authenticated
return { success: true };
},
{
auth: true,
schema: MySchema,
},
);
Route Handler Pattern
import { enhanceRouteHandler } from '@kit/next/routes';
export const POST = enhanceRouteHandler(
async function ({ body, user, request }) {
return NextResponse.json({ success: true });
},
{ auth: true, schema: MySchema },
);
Revalidation
- Use
revalidatePathafter mutations - Never use
router.refresh()orrouter.push()after Server Actions