HIGHArchitecturesmallNext.js + Supabase Standards

Keep server actions in dedicated files

Place server actions in separate *-actions.ts files rather than inline in page components.

Why This Matters

Inline server actions mix data mutation logic with UI rendering, making them harder to test, reuse, and reason about.

Related Rules

Use route groups to organize app sections

Architecture

HIGH

Colocate page files with their route segment

Architecture

MEDIUM

Use (select auth.uid()) instead of auth.uid() in policies

Performance

MEDIUM

Use kebab-case for file and directory names

Quality

MEDIUM

Catch this automatically on every PR

BeforeMerge scans your pull requests against this rule and 3+ others. Get actionable feedback before code ships.

Join Waitlist Browse All Rules

Why This Matters

Server actions in dedicated files are:

Reusable across multiple pages
Testable in isolation (no component rendering needed)
Clear about what mutations exist

Good

// lib/rule-actions.ts
"use server"
 
export async function createRule(data: FormData) {
  const { orgId } = await requireAuth()
  // ... create rule scoped to org
}

Bad

// app/rules/page.tsx
export default function RulesPage() {
  async function handleCreate() {
    "use server"
    // action logic mixed with UI
  }
  return <form action={handleCreate}>...</form>
}

Keep server actions in dedicated files

Why This Matters

Tags

Related Rules

Catch this automatically on every PR

Why This Matters

Good

Bad