MakerKit Patterns Reference

Quick reference for MakerKit project patterns and conventions.

CLAUDE.md File Index

MakerKit includes CLAUDE.md files with patterns for each package:

File	Purpose	Key Content
`CLAUDE.md` (root)	Project overview	Commands, technologies, architecture
`apps/web/CLAUDE.md`	Web app patterns	Routes, async params, data fetching
`apps/web/supabase/CLAUDE.md`	Database patterns	Schema workflow, migrations, RLS
`packages/features/CLAUDE.md`	Feature patterns	Personal vs Team accounts
`packages/supabase/CLAUDE.md`	Supabase helpers	RLS functions, triggers
`packages/ui/CLAUDE.md`	UI components	Available components, form patterns
`packages/next/CLAUDE.md`	Next.js patterns	enhanceAction, enhanceRouteHandler

For detailed content, read references/claude-md-index.md.

Account Types

Personal Account

•User owns their data directly
•FK: user_id → auth.users.id
•RLS: auth.uid() = user_id
•Use when: Single-user features, personal settings

Team Account

•Data belongs to account, shared by members
•FK: account_id → accounts.id
•RLS: has_role_on_account(account_id) - verifica membresía en cuenta
•Use when: Collaborative features, shared resources

Essential MCP Tools

Database Analysis

code

get_database_summary()     → All tables, enums, functions
get_table_info(table)      → Schema details
get_all_enums()            → Existing enum types

Feature Analysis

code

find_complete_features()          → Reference features
analyze_feature_pattern(feature)  → Implementation pattern

Route Analysis

code

get_app_routes()           → Route structure
get_server_actions()       → Action patterns

RLS Generation

code

generate_rls_policy({table, access_type, pattern})
validate_rls_policies({table})

For complete MCP reference, read references/mcp-tools.md.

Quick Patterns

Server Action

typescript

export const myAction = enhanceAction(
  async (data, { user }) => {
    const client = getSupabaseServerClient();
    // ... operation
    return { success: true, data: result };
  },
  { schema: MySchema }
);

Page Loader

typescript

import 'server-only';

export async function loadPageData(
  client: SupabaseClient<Database>,
  accountId: string,
) {
  const { data, error } = await client
    .from('table')
    .select('*')
    .eq('account_id', accountId);

  if (error) throw error;
  return data ?? [];
}

RLS Policy Order

sql

-- 1. Enable RLS
ALTER TABLE public.my_table ENABLE ROW LEVEL SECURITY;

-- 2. Revoke defaults
REVOKE ALL ON public.my_table FROM authenticated, service_role;

-- 3. Grant specific
GRANT SELECT, INSERT, UPDATE, DELETE ON public.my_table TO authenticated;

-- 4. Create policies
CREATE POLICY my_table_select ON public.my_table
  FOR SELECT TO authenticated
  USING (public.has_role_on_account(account_id));

Official Documentation (makerkit-docs)

Para patrones conceptuales que el MCP no cubre, usa el skill makerkit-docs:

Usar MCP cuando...	Usar makerkit-docs cuando...
Necesitas estructura actual del codigo	Necesitas entender conceptos
Que tablas/enums existen	Como funciona billing/auth conceptualmente
Patrones de codigo real	Documentacion oficial de configuracion
Introspeccion del proyecto	Troubleshooting, guias paso a paso

Como invocar: "Usa el skill makerkit-docs para consultar [tema]"

Secciones mas utiles:

•/development/database-architecture - Arquitectura DB
•/billing/overview - Sistema de billing
•/security/row-level-security - RLS patterns
•/troubleshooting/* - Resolucion de problemas

Additional Resources

Reference Files

•references/makerkit-consolidado.md - Quick reference con templates copy-paste ready (PREFERIDO)
•references/claude-md-index.md - Complete CLAUDE.md file contents
•references/mcp-tools.md - All MCP tools with examples

When to Load References

•Need templates for Ralph → read makerkit-consolidado.md (PRIMERO)
•Need specific CLAUDE.md content → read claude-md-index.md
•Need MCP tool details → read mcp-tools.md
•Quick pattern check → use this SKILL.md