create-ern-boilerplate 0.0.52 → 0.0.54

package/create.js

@@ -102,14 +102,36 @@ async function main() {
     const spinner = ora(`📁 Copying template "${templateName}"...`).start();
 
     try {
-        await fs.copy(templateDir, targetDir);
+        // Special handling for fullstack template
+        if (templateName === "agent-generator-fullstack") {
+            const frontendDir = path.join(targetDir, "frontend");
+            const backendDir = path.join(targetDir, "backend");
 
-        // === Rename .gitignore-template → .gitignore ===
-        const gitignoreTemplatePath = path.join(targetDir, ".gitignore-template");
-        const gitignorePath = path.join(targetDir, ".gitignore");
+            // Create directories
+            await fs.ensureDir(frontendDir);
+            await fs.ensureDir(backendDir);
 
-        if (await fs.pathExists(gitignoreTemplatePath)) {
-            await fs.move(gitignoreTemplatePath, gitignorePath);
+            // Copy template to frontend/
+            await fs.copy(templateDir, frontendDir);
+
+            // Handle .gitignore-template in frontend/
+            const gitignoreTemplatePath = path.join(frontendDir, ".gitignore-template");
+            const gitignorePath = path.join(frontendDir, ".gitignore");
+
+            if (await fs.pathExists(gitignoreTemplatePath)) {
+                await fs.move(gitignoreTemplatePath, gitignorePath);
+            }
+        } else {
+            // Normal template copy
+            await fs.copy(templateDir, targetDir);
+
+            // === Rename .gitignore-template → .gitignore ===
+            const gitignoreTemplatePath = path.join(targetDir, ".gitignore-template");
+            const gitignorePath = path.join(targetDir, ".gitignore");
+
+            if (await fs.pathExists(gitignoreTemplatePath)) {
+                await fs.move(gitignoreTemplatePath, gitignorePath);
+            }
         }
 
 
@@ -125,7 +147,10 @@ async function main() {
         };
 
         // === Update package.json ===
-        const pkgPath = path.join(targetDir, "package.json");
+        const pkgPath = templateName === "agent-generator-fullstack"
+            ? path.join(targetDir, "frontend", "package.json")
+            : path.join(targetDir, "package.json");
+
         if (fs.existsSync(pkgPath)) {
             const pkg = await fs.readJson(pkgPath);
             pkg.name = projectName.toLowerCase().replace(/\s+/g, "-");;
@@ -214,16 +239,51 @@ async function main() {
 
 
         // === Detect & update app.json OR app.config.js ===
-        const appConfigJsPath = path.join(targetDir, "app.config.js");
+        const baseDir = templateName === "agent-generator-fullstack"
+            ? path.join(targetDir, "frontend")
+            : targetDir;
+
+        const appConfigJsPath = path.join(baseDir, "app.config.js");
 
         if (fs.existsSync(appConfigJsPath)) {
             // update dynamic config
             await updateAppConfigJs(appConfigJsPath, projectName);
         } else {
             // update JSON configs
-            await updateAppJson("app.json");
-            await updateAppJson("app.staging.json", "staging");
-            await updateAppJson("app.prod.json", "production");
+            const updateAppJsonWithPath = async (file, env = null) => {
+                const filePath = path.join(baseDir, file);
+                if (!fs.existsSync(filePath)) return;
+
+                const json = await fs.readJson(filePath);
+
+                json.expo = json.expo || {};
+                json.expo.name = projectName;
+                json.expo.slug = projectName.toLowerCase().replace(/\s+/g, "-");
+
+                json.expo.ios = json.expo.ios || {};
+                json.expo.android = json.expo.android || {};
+
+                json.expo.ios.bundleIdentifier = `com.${projectName.toLowerCase()}.app`;
+                json.expo.android.package = `com.${projectName.toLowerCase()}.app`;
+
+                json.expo.scheme = projectName.toLowerCase();
+
+                if (json.expo.extra && json.expo.extra.eas) {
+                    json.expo.extra.eas.projectId = "";
+                }
+
+                if (env) {
+                    json.expo.extra = json.expo.extra || {};
+                    json.expo.extra.ENV = env;
+                    json.expo.extra.BASE_URL = "";
+                }
+
+                await fs.writeJson(filePath, json, { spaces: 2 });
+            };
+
+            await updateAppJsonWithPath("app.json");
+            await updateAppJsonWithPath("app.staging.json", "staging");
+            await updateAppJsonWithPath("app.prod.json", "production");
         }
 
         spinner.succeed(`✅ Template "${templateName}" has been created!`);
@@ -237,8 +297,15 @@ async function main() {
     if (autoInstall) {
         const installSpinner = ora("📦 Installing dependencies...").start();
         try {
-            execSync("npm install", { cwd: targetDir, stdio: "inherit" });
-            installSpinner.succeed("✅ Dependencies installed successfully!");
+            if (templateName === "agent-generator-fullstack") {
+                // Install frontend dependencies
+                const frontendPath = path.join(targetDir, "frontend");
+                execSync("npm install", { cwd: frontendPath, stdio: "inherit" });
+                installSpinner.succeed("✅ Frontend dependencies installed successfully!");
+            } else {
+                execSync("npm install", { cwd: targetDir, stdio: "inherit" });
+                installSpinner.succeed("✅ Dependencies installed successfully!");
+            }
         } catch (err) {
             installSpinner.fail("❌ Failed to install dependencies.");
             console.error(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ern-boilerplate",
-  "version": "0.0.52",
+  "version": "0.0.54",
   "description": "Expo React Native boilerplate generator",
   "bin": {
     "create-ern-boilerplate": "./create.js",

package/templates/agent-generator-fullstack/.gitignore-template

@@ -0,0 +1,80 @@
+# OSX
+.DS_Store
+
+# Xcode
+build/
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata
+*.xccheckout
+*.moved-aside
+DerivedData
+*.hmap
+*.ipa
+*.xcuserstate
+project.xcworkspace
+
+# Android
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+
+# Node
+node_modules/
+npm-debug.log
+yarn-error.log
+
+# Expo
+.expo/
+dist/
+web-build/
+
+# Environment
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# TypeScript
+*.tsbuildinfo
+
+# Metro
+.metro-health-check*
+
+# Debug
+*.log*
+# @generated expo-cli sync-2b81b286409207a5da26e14c78851eb30d8ccbdb
+# The following patterns were generated by expo-cli
+
+expo-env.d.ts
+# @end expo-cli
+
+# Other
+structure.txt
+.claude
+examples
+ai-context.json
+AI_GUIDE.md
+CONVENTIONS.md
+GENERATE_RULES.md
+SERVER_GUIDE.md
+TEMPLATE_VARIANTS.md
+CUSTOMIZATION.md

package/templates/agent-generator-fullstack/AI_GUIDE.md

@@ -0,0 +1,233 @@
+# AI Agent Guide
+
+Quick start guide for AI agents working with this boilerplate.
+
+## 🚀 First Time Setup
+
+When you first enter this project, read these files **in order**:
+
+1. **This file** (AI_GUIDE.md) - Quick start and navigation
+2. **`ai-context.json`** - Path mappings for code generation
+3. **`CUSTOMIZATION.md`** - Choose template variant for your app
+4. **`PATTERNS.md`** - Code generation rules and tech stack
+5. **`CONVENTIONS.md`** - Coding standards and best practices
+6. **`SERVER_GUIDE.md`** - Mock API and dummy data (if using API)
+7. **`examples/`** - Working code patterns
+
+## 📖 Documentation Map
+
+Each file has a specific purpose:
+
+| File | Purpose | When to Read |
+|------|---------|--------------|
+| **AI_GUIDE.md** | Navigation & quick start | First time in project |
+| **ai-context.json** | Path mappings | When generating code |
+| **CUSTOMIZATION.md** | Template variants | Choosing app architecture |
+| **PATTERNS.md** | Tech stack & generation rules | Before writing code |
+| **CONVENTIONS.md** | Coding standards | When writing code |
+| **SERVER_GUIDE.md** | Mock API & dummy data | When adding data models |
+| **examples/** | Working code patterns | Before implementing features |
+
+## 🚨 Critical Rules Summary
+
+**Full details in respective files. This is just a quick reference.**
+
+### 🔴 MOST IMPORTANT: Mock API Default (See SERVER_GUIDE.md)
+
+**ALWAYS use Mock API unless user EXPLICITLY requests otherwise!**
+
+- ✅ **DEFAULT BEHAVIOR: Use Mock API** - Always create mock API for any feature
+- ✅ Use `service-with-mock.example.ts` pattern for services
+- ✅ Add 2-4 sample items to `server/db.json`
+- ✅ Create mock API file in `src/services/mockApi/`
+- ❌ **NEVER connect to real API** unless user explicitly says:
+  - "use real API"
+  - "connect to actual backend"
+  - "no mock, use production API"
+- ❌ **NEVER skip mock API** for online features
+
+**Exception: Only skip Mock API if user requests:**
+1. **Offline-only app** (use AsyncStorage - see `offline-service.example.ts`)
+2. **Explicit real API request** ("connect to real API", "use production backend")
+
+### Tech Stack (See PATTERNS.md)
+- ⚠️ **NEVER add new dependencies** without permission
+- ✅ Use only packages in package.json
+- 📦 React 19.1.0, React Native 0.81.4, Expo SDK 54
+
+### Coding Standards (See CONVENTIONS.md)
+- ✅ Use TypeScript with proper types
+- ✅ Use path aliases `@/` not `../../`
+- ✅ Support light/dark theme always
+- ✅ Handle loading and error states
+
+## 🎯 Quick Decision Guide
+
+### Choose Your Template Variant
+
+**See `CUSTOMIZATION.md` for full guide. Quick reference:**
+
+```
+Does your app need user accounts?
+├─ NO
+│   ├─ Need API? → NO  → Variant: Offline (examples/apps/todo-offline/)
+│   │                    ✅ Use: offline-service.example.ts
+│   │
+│   └─ Need API? → YES → Variant: Public Content (examples/apps/news-no-auth/)
+│                         ✅ DEFAULT: Use Mock API with service-with-mock.example.ts
+│                         ❌ NEVER use real API unless user explicitly requests it
+│
+└─ YES
+    └─ Need API? → YES → Variant: Protected (examples/apps/dashboard-with-auth/)
+                          ✅ DEFAULT: Use Mock API with service-with-mock.example.ts
+                          ❌ NEVER use real API unless user explicitly requests it
+```
+
+**🔴 IMPORTANT:** When user says "Need API", it means **Mock API by default**!
+
+### Choose Your Examples
+
+**See `examples/` folder. Quick reference:**
+
+#### Screen Patterns (`examples/screens/`)
+- **Public list** → `list-screen-no-auth.example.tsx`
+- **Protected list** → `list-screen-with-auth.example.tsx`
+- **Forms** → `form-screen.example.tsx`
+- **Detail pages** → `detail-screen.example.tsx`
+
+#### Service Patterns (`examples/services/`)
+- **✅ DEFAULT: API with mock** → `service-with-mock.example.ts` (Use this for any online feature)
+- **❌ Direct API only** → `service-without-mock.example.ts` (Only if user explicitly requests real API)
+- **Offline storage** → `offline-service.example.ts` (Only for offline-only apps)
+
+#### Complete Apps (`examples/apps/`)
+- **Offline app** → `todo-offline/README.md`
+- **Public content** → `news-no-auth/README.md`
+- **Protected dashboard** → `dashboard-with-auth/README.md`
+
+## 📋 Code Generation Workflow
+
+**See `PATTERNS.md` for detailed patterns.**
+
+### Quick Steps:
+1. ✅ Understand user request
+2. ✅ **Determine API strategy:**
+   - **DEFAULT: Use Mock API** (unless explicitly told otherwise)
+   - Only use offline storage if user says "offline-only app"
+   - Only skip mock if user says "use real API" or "connect to actual backend"
+3. ✅ Check `examples/` for similar pattern
+4. ✅ Check `CUSTOMIZATION.md` for variant
+5. ✅ Create types in `src/types/`
+6. ✅ **Add sample data to `server/db.json`** (if using Mock API - which is DEFAULT)
+7. ✅ **Create mock API in `src/services/mockApi/`** (if using Mock API - which is DEFAULT)
+8. ✅ Create service in `src/services/` (use `service-with-mock.example.ts` pattern by DEFAULT)
+9. ✅ Create components in `src/components/`
+10. ✅ Create screens in `app/(tabs)/`
+11. ✅ Update navigation
+
+## 📁 File Locations
+
+**See `ai-context.json` for complete mappings.**
+
+Quick reference:
+```
+app/(tabs)/                    → Screens
+src/components/                → Components
+src/hooks/                     → Custom hooks
+src/services/                  → API services
+src/services/mockApi/          → Mock API implementations (auth, users only)
+src/store/                     → Zustand stores
+src/types/                     → TypeScript types
+server/db.json                 → Mock data (users only by default)
+examples/                      → Code examples
+examples/services/mockApi/     → Mock API pattern examples (basic & advanced CRUD)
+examples/types/                → Type definition examples (generic resource types)
+```
+
+## ⚠️ Common Mistakes to Avoid
+
+**Full list in `CONVENTIONS.md`. Quick reference:**
+
+1. ❌ **Don't skip Mock API** - Always use mock API by default for online features
+2. ❌ **Don't connect to real API** - Unless user explicitly requests it
+3. ❌ Don't add new dependencies
+4. ❌ Don't use relative imports (`../../`)
+5. ❌ Don't skip theme support
+6. ❌ Don't skip loading/error states
+7. ❌ Don't ignore examples - always check first!
+
+## 💡 Pro Tips
+
+1. **When in doubt, check examples/** - Don't reinvent patterns
+2. **Use ai-context.json** - All paths are there
+3. **Check CUSTOMIZATION.md first** - Choose right variant
+4. **Read PATTERNS.md** - Understand tech stack rules
+5. **Follow CONVENTIONS.md** - Consistent code style
+6. **Use SERVER_GUIDE.md** - When adding data models
+
+## 📞 Quick Commands
+
+```bash
+# Read documentation in order
+cat AI_GUIDE.md              # ← Start here
+cat ai-context.json          # Path mappings
+cat CUSTOMIZATION.md         # Choose variant
+cat PATTERNS.md              # Generation rules
+cat CONVENTIONS.md           # Coding standards
+cat SERVER_GUIDE.md          # Mock API guide
+
+# Check examples
+ls examples/screens/         # Screen patterns
+ls examples/services/        # Service patterns
+ls examples/services/mockApi/  # Mock API pattern examples
+ls examples/types/           # Type definition examples
+ls examples/apps/            # Complete app examples
+
+# Check current structure
+cat server/db.json           # Mock data (users only)
+ls src/types/                # Type definitions (auth, user types)
+ls src/services/mockApi/     # Active mock API files (auth, users)
+```
+
+## ✅ Success Checklist
+
+Your generated code is good if:
+
+- [ ] **Uses Mock API by default** (unless explicitly told to use real API or offline-only)
+- [ ] Uses `service-with-mock.example.ts` pattern for services (DEFAULT)
+- [ ] Dummy data (2-4 items) added to `server/db.json`
+- [ ] Mock API file created in `src/services/mockApi/`
+- [ ] Uses ONLY existing packages from package.json
+- [ ] Follows examples/ patterns
+- [ ] Uses TypeScript with proper types
+- [ ] Uses path aliases (`@/`)
+- [ ] Supports light/dark theme
+- [ ] Handles loading/error states
+- [ ] Uses NativeWind classes
+- [ ] Follows naming conventions
+
+## 🎓 Learning Path
+
+### For News App:
+1. Read `CUSTOMIZATION.md` → Choose "Public Content" variant
+2. Read `examples/apps/news-no-auth/README.md`
+3. Follow `examples/screens/list-screen-no-auth.example.tsx`
+4. Follow `examples/services/service-with-mock.example.ts`
+
+### For Todo App:
+1. Read `CUSTOMIZATION.md` → Choose "Offline" variant
+2. Read `examples/apps/todo-offline/README.md`
+3. Follow `examples/services/offline-service.example.ts`
+
+### For Dashboard:
+1. Read `CUSTOMIZATION.md` → Keep "Protected" variant (default)
+2. Read `examples/apps/dashboard-with-auth/README.md`
+3. Follow `examples/screens/list-screen-with-auth.example.tsx`
+
+---
+
+**Remember:**
+- This file is your **navigation guide**
+- For details, see the **specific documentation files**
+- Always **check examples/** before generating code
+- Keep it **simple** and follow existing patterns