Jerry
79 lines
2.0 KiB
Plaintext
79 lines
2.0 KiB
Plaintext
---
|
|
description:
|
|
globs: *.sql,supabase.ts,supabase/*
|
|
alwaysApply: false
|
|
---
|
|
# Database Workflow Rules
|
|
version: 1.0.0
|
|
|
|
## Database Schema Changes
|
|
|
|
### NEVER Create Manual Migrations
|
|
- Do NOT manually create migration files in `supabase/migrations/`
|
|
- Always use the declarative schema approach
|
|
- Update schema files in `supabase/schemas/` folder instead
|
|
- Only modify generated migrations files if absolutely necessary
|
|
|
|
### Schema File Management
|
|
- Modify existing table schemas in `supabase/schemas/` files
|
|
- Add new tables by creating new schema files
|
|
- Follow the existing schema file patterns and naming conventions
|
|
|
|
## Migration Generation Process
|
|
|
|
### Step 1: Stop Supabase
|
|
```bash
|
|
supabase stop
|
|
```
|
|
|
|
### Step 2: Generate Migration
|
|
```bash
|
|
supabase db diff -f <migration_name>
|
|
```
|
|
- Replace `<migration_name>` with descriptive name (e.g., `add_user_preferences`, `create_new_table`)
|
|
- Migration will be generated in `supabase/migrations/` with timestamp
|
|
|
|
### Step 3: Apply Migration
|
|
```bash
|
|
supabase start && supabase migration up
|
|
```
|
|
|
|
## Local Development Only
|
|
|
|
### CRITICAL: Never Push to Remote
|
|
- NEVER use `supabase db push`
|
|
- NEVER use `supabase db pull`
|
|
- ALL migrations should be tested locally only
|
|
- Remote database changes are forbidden
|
|
|
|
## Type Generation
|
|
|
|
### Auto-Generate Types
|
|
- NEVER manually edit `shared/database.ts`
|
|
- Always regenerate after schema changes:
|
|
```bash
|
|
supabase gen types typescript --local > shared/database.ts
|
|
```
|
|
|
|
## Workflow Summary
|
|
|
|
1. **Edit Schema**: Modify `supabase/schemas/` files
|
|
2. **Stop Database**: `supabase stop`
|
|
3. **Generate Migration**: `supabase db diff -f <name>`
|
|
4. **Apply Migration**: `supabase start && supabase migration up`
|
|
5. **Update Types**: `supabase gen types typescript --local > shared/database.ts`
|
|
|
|
## Common Commands Reference
|
|
|
|
```bash
|
|
# Development workflow
|
|
supabase stop
|
|
supabase db diff -f <migration_name>
|
|
supabase start && supabase migration up
|
|
supabase gen types typescript --local > shared/database.ts
|
|
|
|
# NEVER use these commands
|
|
# supabase db push ❌
|
|
# supabase db pull ❌
|
|
```
|