Update TEMPLATE_README.md

TEMPLATE_README.md

@@ -0,0 +1,57 @@
+# AI SaaS Template
+
+This is the default template for all new Kleap apps. It includes a complete Next.js 15 starter with everything configured.
+
+## ⚡ Template Synchronization
+
+After making changes to this template, you MUST sync it to Supabase:
+
+```bash
+# Sync only modified files
+npm run sync-template
+
+# Force update all files (even if unchanged)
+npm run sync-template:force
+```
+
+## 📁 Template Structure
+
+- `app/` - Next.js 15 App Router pages
+- `components/` - React components
+- `lib/` - Utility functions
+- `public/` - Static assets
+- `AI_RULES.md` - Instructions for the AI when working with this template
+
+## 🚀 How It Works
+
+1. Template files are stored in Supabase with `app_id = -1`
+2. When a new app is created, files are copied via SQL (DB-to-DB)
+3. Copy time: <1 second (vs 20-60 seconds with traditional method)
+
+## ✏️ Making Changes
+
+1. Edit files in this directory
+2. Run `npm run sync-template`
+3. New apps will use the updated template
+
+## ⚠️ Important Notes
+
+- Changes only affect NEW apps, not existing ones
+- The `.kleapignore` file controls which files are synced
+- Binary files (images, fonts) are automatically handled
+- The sync script shows which files are added/updated/deleted
+
+## 🔍 Verifying Sync
+
+After syncing, the script will show:
+- ✅ Unchanged files (already in sync)
+- ➕ New files added
+- 📝 Updated files
+- ❌ Deleted files
+
+## 🛠️ Troubleshooting
+
+If sync fails:
+1. Check Supabase credentials in `.env.local`
+2. Ensure you have the migration applied (see CLAUDE.md)
+3. Check the console for detailed error messages