umpordez 1.0.3 → 1.2.1

package/create.mjs

@@ -5,6 +5,8 @@ import path from 'node:path';
 import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { buildReplacements } from './template-variables.mjs';
+import { generateIcons } from './icons.mjs';
+import { writeInitialManifest } from './update.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const TEMPLATE_DIR = path.join(__dirname, 'template');
@@ -22,11 +24,64 @@ const BINARY_EXTENSIONS = new Set([
     '.pdf', '.mp3', '.mp4', '.webm', '.ogg',
 ]);
 
+// Presets describe which top-level template directories ship in a new
+// project. The CLI scrubs the rest after copying — keeps the template
+// structure unconditional and the create-time logic dead simple.
+const PRESETS = {
+    everything: {
+        label: 'Everything (server + admin UI + site + mobile)',
+        includes: ['server', 'ui/admin', 'ui/site', 'mobile', 'misc',
+                   'scripts', 'doc'],
+        wantsMobile: true,
+        wantsServer: true,
+        wantsAdminUi: true,
+        wantsSite: true,
+    },
+    'web-only': {
+        label: 'Web only (server + admin UI + site, no mobile)',
+        includes: ['server', 'ui/admin', 'ui/site', 'misc', 'doc'],
+        wantsMobile: false,
+        wantsServer: true,
+        wantsAdminUi: true,
+        wantsSite: true,
+    },
+    'mobile-and-server': {
+        label: 'Mobile + server only (no admin UI, no site)',
+        includes: ['server', 'mobile', 'misc', 'scripts', 'doc'],
+        wantsMobile: true,
+        wantsServer: true,
+        wantsAdminUi: false,
+        wantsSite: false,
+    },
+    'just-mobile': {
+        label: 'Just mobile (assumes external API)',
+        includes: ['mobile', 'scripts', 'doc'],
+        wantsMobile: true,
+        wantsServer: false,
+        wantsAdminUi: false,
+        wantsSite: false,
+    },
+};
+
+const ROOT_FILES_BY_PRESET = {
+    everything:           ['CLAUDE.md', 'AGENTS.md', 'README.md',
+                           'architecture.md', 'code.md',
+                           'install.sh', 'seed.sh', 'dev.sh'],
+    'web-only':           ['CLAUDE.md', 'AGENTS.md', 'README.md',
+                           'architecture.md', 'code.md',
+                           'install.sh', 'seed.sh', 'dev.sh'],
+    'mobile-and-server':  ['CLAUDE.md', 'AGENTS.md', 'README.md',
+                           'architecture.md', 'code.md',
+                           'install.sh', 'seed.sh', 'dev.sh'],
+    'just-mobile':        ['CLAUDE.md', 'README.md', 'code.md',
+                           'install.sh', 'dev.sh'],
+};
+
 function slugify(text) {
     return text
         .toLowerCase()
         .normalize('NFD')
-        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[̀-ͯ]/g, '')
         .replace(/[^a-z0-9]+/g, '-')
         .replace(/^-|-$/g, '');
 }
@@ -35,11 +90,30 @@ function toDbName(slug) {
     return slug.replace(/-/g, '_');
 }
 
+function toReverseDomain(domain) {
+    // "minhaempresa.com.br" → "br.com.minhaempresa"
+    const parts = domain.toLowerCase().split('.').filter(Boolean);
+    return parts.reverse().join('.');
+}
+
 async function promptProjectDetails() {
     console.log(green.bold('  Project Setup'));
-    console.log(chalk.hex('#2c2c2c')('  ' + '\u2500'.repeat(40)));
+    console.log(chalk.hex('#2c2c2c')('  ' + '─'.repeat(40)));
     console.log('');
 
+    const { preset } = await inquirer.prompt([{
+        type: 'list',
+        name: 'preset',
+        message: 'What do you want to generate?',
+        choices: Object.entries(PRESETS).map(([value, def]) => ({
+            name: def.label,
+            value,
+        })),
+        default: 'everything',
+    }]);
+
+    const presetDef = PRESETS[preset];
+
     const { name } = await inquirer.prompt([{
         type: 'input',
         name: 'name',
@@ -50,7 +124,7 @@ async function promptProjectDetails() {
     const suggestedSlug = slugify(name);
     const suggestedDb = toDbName(suggestedSlug);
 
-    const answers = await inquirer.prompt([
+    const baseQuestions = [
         {
             type: 'input',
             name: 'slug',
@@ -72,6 +146,9 @@ async function promptProjectDetails() {
             message: 'Domain (e.g. "minhaempresa.com.br"):',
             validate: (v) => v.trim() ? true : 'Domain is required',
         },
+    ];
+
+    const serverQuestions = !presetDef.wantsServer ? [] : [
         {
             type: 'input',
             name: 'dbName',
@@ -81,12 +158,6 @@ async function promptProjectDetails() {
                 ? true
                 : 'Database name must be lowercase with underscores',
         },
-        {
-            type: 'input',
-            name: 'outputDir',
-            message: 'Output directory:',
-            default: `./${suggestedSlug}`,
-        },
         {
             type: 'input',
             name: 'adminEmail',
@@ -105,36 +176,43 @@ async function promptProjectDetails() {
             name: 'apiPort',
             message: 'Admin API port:',
             default: '4000',
-            validate: (v) => /^\d+$/.test(v) && +v > 0 && +v < 65536
-                ? true
-                : 'Must be a valid port number',
+            validate: validatePort,
         },
         {
             type: 'input',
             name: 'siteApiPort',
             message: 'Site API port:',
             default: '4001',
-            validate: (v) => /^\d+$/.test(v) && +v > 0 && +v < 65536
-                ? true
-                : 'Must be a valid port number',
+            validate: validatePort,
         },
+    ];
+
+    const webUiQuestions = !presetDef.wantsAdminUi ? [] : [
         {
             type: 'input',
             name: 'adminUiPort',
             message: 'Admin panel port:',
             default: '5173',
-            validate: (v) => /^\d+$/.test(v) && +v > 0 && +v < 65536
-                ? true
-                : 'Must be a valid port number',
+            validate: validatePort,
         },
+    ];
+
+    const siteQuestions = !presetDef.wantsSite ? [] : [
         {
             type: 'input',
             name: 'sitePort',
             message: 'Public site port:',
             default: '3000',
-            validate: (v) => /^\d+$/.test(v) && +v > 0 && +v < 65536
-                ? true
-                : 'Must be a valid port number',
+            validate: validatePort,
+        },
+    ];
+
+    const styleQuestions = [
+        {
+            type: 'input',
+            name: 'outputDir',
+            message: 'Output directory:',
+            default: `./${suggestedSlug}`,
         },
         {
             type: 'input',
@@ -157,36 +235,114 @@ async function promptProjectDetails() {
             ],
             default: 'light',
         },
+    ];
+
+    const mobileQuestions = !presetDef.wantsMobile ? [] : [
+        {
+            type: 'input',
+            name: 'iosBundleId',
+            message: 'iOS bundle identifier:',
+            default: ({ domain }) => `${toReverseDomain(domain || '')}.app`,
+            validate: (v) => /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+$/i.test(v)
+                ? true
+                : 'Must be reverse-DNS (e.g. com.brand.app)',
+        },
+        {
+            type: 'input',
+            name: 'androidPackage',
+            message: 'Android package:',
+            default: ({ iosBundleId }) =>
+                iosBundleId ? iosBundleId.replace(/\.app$/, '') : '',
+            validate: (v) => /^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$/i.test(v)
+                ? true
+                : 'Must be reverse-DNS using underscores (e.g. br.com.brand)',
+        },
+        {
+            type: 'input',
+            name: 'mobileScheme',
+            message: 'Mobile URL scheme (deep links):',
+            default: ({ slug }) => slug,
+            validate: (v) => /^[a-z][a-z0-9-]*$/.test(v)
+                ? true
+                : 'Lowercase alphanumeric, dashes allowed',
+        },
+    ];
+
+    const answers = await inquirer.prompt([
+        ...baseQuestions,
+        ...serverQuestions,
+        ...webUiQuestions,
+        ...siteQuestions,
+        ...styleQuestions,
+        ...mobileQuestions,
     ]);
 
-    return { name: name.trim(), ...answers };
+    return {
+        preset,
+        presetDef,
+        name: name.trim(),
+        // Defaults for the parts the user didn't see — they're still
+        // referenced by replacements (some unconditionally), so we fill
+        // safe placeholders.
+        dbName:        answers.dbName        ?? suggestedDb,
+        adminEmail:    answers.adminEmail    ?? 'admin@localhost.com',
+        adminPassword: answers.adminPassword ?? 'admin123',
+        apiPort:       answers.apiPort       ?? '4000',
+        siteApiPort:   answers.siteApiPort   ?? '4001',
+        adminUiPort:   answers.adminUiPort   ?? '5173',
+        sitePort:      answers.sitePort      ?? '3000',
+        iosBundleId:    answers.iosBundleId
+            ?? `${toReverseDomain(answers.domain)}.app`,
+        androidPackage: answers.androidPackage
+            ?? toReverseDomain(answers.domain),
+        mobileScheme:   answers.mobileScheme ?? answers.slug,
+        ...answers,
+    };
+}
+
+function validatePort(v) {
+    return /^\d+$/.test(v) && +v > 0 && +v < 65536
+        ? true
+        : 'Must be a valid port number';
 }
 
 function showSummary(details) {
+    const { presetDef } = details;
     console.log('');
     console.log(green.bold('  Project Summary'));
-    console.log(chalk.hex('#2c2c2c')('  ' + '\u2500'.repeat(40)));
+    console.log(chalk.hex('#2c2c2c')('  ' + '─'.repeat(40)));
     console.log('');
+    console.log(`  ${chalk.bold('Preset:')}       ${cyan(presetDef.label)}`);
     console.log(`  ${chalk.bold('Name:')}         ${cyan(details.name)}`);
     console.log(`  ${chalk.bold('Slug:')}         ${details.slug}`);
     console.log(`  ${chalk.bold('Description:')}  ${details.description || dim('(none)')}`);
     console.log(`  ${chalk.bold('Domain:')}       ${cyan(details.domain)}`);
-    console.log(`  ${chalk.bold('Database:')}     ${details.dbName}`);
+    if (presetDef.wantsServer) {
+        console.log(`  ${chalk.bold('Database:')}     ${details.dbName}`);
+        console.log(`  ${chalk.bold('Admin:')}        ${details.adminEmail}`);
+    }
     console.log(`  ${chalk.bold('Output:')}       ${details.outputDir}`);
-    console.log(`  ${chalk.bold('Admin:')}        ${details.adminEmail}`);
-    console.log(`  ${chalk.bold('Ports:')}        API ${cyan(details.apiPort)} | Site API ${cyan(details.siteApiPort)} | Admin ${cyan(details.adminUiPort)} | Site ${cyan(details.sitePort)}`);
-    console.log(`  ${chalk.bold('Color:')}        ${chalk.hex(details.primaryColor)('\u2588\u2588')} ${details.primaryColor}`);
+    const ports = [];
+    if (presetDef.wantsServer)  ports.push(`API ${cyan(details.apiPort)} | Site API ${cyan(details.siteApiPort)}`);
+    if (presetDef.wantsAdminUi) ports.push(`Admin ${cyan(details.adminUiPort)}`);
+    if (presetDef.wantsSite)    ports.push(`Site ${cyan(details.sitePort)}`);
+    if (ports.length) {
+        console.log(`  ${chalk.bold('Ports:')}        ${ports.join(' | ')}`);
+    }
+    console.log(`  ${chalk.bold('Color:')}        ${chalk.hex(details.primaryColor)('██')} ${details.primaryColor}`);
     console.log(`  ${chalk.bold('Theme:')}        ${details.defaultTheme}`);
+    if (presetDef.wantsMobile) {
+        console.log(`  ${chalk.bold('iOS:')}          ${details.iosBundleId}`);
+        console.log(`  ${chalk.bold('Android:')}      ${details.androidPackage}`);
+        console.log(`  ${chalk.bold('Scheme:')}       ${details.mobileScheme}://`);
+    }
     console.log('');
-    console.log(dim('  What gets generated:'));
-    console.log(dim(`  ${green('>')} Admin API (Express + TypeScript)`));
-    console.log(dim(`  ${green('>')} Site API (Express + TypeScript)`));
-    console.log(dim(`  ${green('>')} React admin panel (Vite + shadcn/ui)`));
-    console.log(dim(`  ${green('>')} Public site (EJS + Tailwind)`));
-    console.log(dim(`  ${green('>')} PostgreSQL migrations + seed`));
-    console.log(dim(`  ${green('>')} S3 file uploads`));
-    console.log(dim(`  ${green('>')} Console task runner`));
-    console.log(dim(`  ${green('>')} Production build system`));
+    console.log(dim('  Generates:'));
+    if (presetDef.wantsServer)  console.log(dim(`  ${green('>')} Admin API + Site API (Express + TS)`));
+    if (presetDef.wantsAdminUi) console.log(dim(`  ${green('>')} React admin panel (Vite + shadcn/ui)`));
+    if (presetDef.wantsSite)    console.log(dim(`  ${green('>')} Public site (EJS + Tailwind)`));
+    if (presetDef.wantsMobile)  console.log(dim(`  ${green('>')} Mobile app (Expo + TS + auth + theme)`));
+    if (presetDef.wantsServer)  console.log(dim(`  ${green('>')} PostgreSQL migrations + seed`));
     console.log('');
 }
 
@@ -218,6 +374,76 @@ function replacePlaceholders(content, replacements) {
     return result;
 }
 
+// Copies the parts of the template the preset asks for. We always
+// recursively copy the whole template tree first then prune what the
+// preset doesn't want — simpler than walking with a filter function and
+// keeps the template layout flat in source.
+// Top-level directories that ship with every preset regardless of
+// what the user picked. Project-level config (Claude rules, editor
+// config, git ignore) doesn't belong to any single sub-app.
+const ALWAYS_KEEP = new Set(['.claude']);
+
+async function copyTemplate(outputDir, preset) {
+    const presetDef = PRESETS[preset];
+    await fs.promises.cp(TEMPLATE_DIR, outputDir, { recursive: true });
+
+    // Top-level dirs to keep
+    const keep = new Set([...presetDef.includes, ...ALWAYS_KEEP]);
+    const entries = await fs.promises.readdir(outputDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        // Special-case ui/: keep only the requested children
+        if (entry.name === 'ui') {
+            const wantedChildren = presetDef.includes
+                .filter(p => p.startsWith('ui/'))
+                .map(p => p.slice('ui/'.length));
+            if (wantedChildren.length === 0) {
+                await fs.promises.rm(
+                    path.join(outputDir, 'ui'),
+                    { recursive: true, force: true }
+                );
+                continue;
+            }
+            const uiEntries = await fs.promises.readdir(
+                path.join(outputDir, 'ui'),
+                { withFileTypes: true }
+            );
+            for (const uiEntry of uiEntries) {
+                if (!wantedChildren.includes(uiEntry.name)) {
+                    await fs.promises.rm(
+                        path.join(outputDir, 'ui', uiEntry.name),
+                        { recursive: true, force: true }
+                    );
+                }
+            }
+            continue;
+        }
+        if (!keep.has(entry.name)) {
+            await fs.promises.rm(
+                path.join(outputDir, entry.name),
+                { recursive: true, force: true }
+            );
+        }
+    }
+
+    // Top-level files: drop dev.sh / seed.sh etc. when not relevant
+    const allowedFiles = new Set(ROOT_FILES_BY_PRESET[preset] ?? []);
+    const rootEntries = await fs.promises.readdir(outputDir, {
+        withFileTypes: true
+    });
+    for (const entry of rootEntries) {
+        if (entry.isDirectory()) {
+            continue;
+        }
+        if (!allowedFiles.has(entry.name)) {
+            await fs.promises.rm(path.join(outputDir, entry.name));
+        }
+    }
+}
+
 export async function createProject() {
     const details = await promptProjectDetails();
 
@@ -252,12 +478,17 @@ export async function createProject() {
     }
 
     const replacements = buildReplacements(details);
+    // Lift the random secrets into details so the manifest persists
+    // them — otherwise `umpordez update` would mint fresh ones and
+    // overwrite working .env values on every run.
+    details.contentSecret = replacements['{{CONTENT_SECRET}}'];
+    details.jwtTokenSecret = replacements['{{JWT_TOKEN_SECRET}}'];
 
     console.log('');
 
-    // [1/5] Copy template
+    // [1/5] Copy template (preset-aware pruning)
     console.log(green('[1/5]') + ' Copying template files...');
-    await fs.promises.cp(TEMPLATE_DIR, outputDir, { recursive: true });
+    await copyTemplate(outputDir, details.preset);
 
     // [2/5] Replace placeholders
     const files = await getAllFiles(outputDir);
@@ -279,7 +510,7 @@ export async function createProject() {
 
     console.log(green('[2/5]') + ` Replacing placeholders... ${dim(`(${replacedCount} files updated)`)}`);
 
-    // [3/5] Rename files
+    // [3/5] Rename files (path-name placeholders)
     const allEntries = await getAllFiles(outputDir);
     for (const filePath of allEntries) {
         const dir = path.dirname(filePath);
@@ -292,15 +523,51 @@ export async function createProject() {
         }
     }
 
+    // Path-segment renames (e.g. mobile/{{PROJECT_SLUG}}/)
+    await renameDirs(outputDir, details.slug);
+
     console.log(green('[3/5]') + ' Renaming template files...');
 
-    // [4/5] Make scripts executable
+    // [4/6] Generate branded icons (mobile only). The template ships
+    // NO icon PNGs — they're produced fresh per project from the
+    // primary color + first letter of the project name. A failure
+    // here is fatal (without these files, expo prebuild + the app
+    // splash both break), so we surface the error instead of swallowing.
+    if (details.presetDef.wantsMobile) {
+        const mobileAssets = path.join(
+            outputDir, 'mobile', details.slug, 'assets'
+        );
+        await generateIcons({
+            outDir: mobileAssets,
+            primaryColor: details.primaryColor,
+            letter: details.name.charAt(0).toUpperCase()
+        });
+        console.log(
+            green('[4/6]')
+            + ' Generating branded icons...'
+            + dim(' (icon, splash, favicon, store)')
+        );
+    } else {
+        console.log(green('[4/6]') + dim(' Skipping icons (no mobile)'));
+    }
+
+    // [5/6] Make scripts executable
     const scripts = [
         'dev.sh',
         'install.sh',
         'seed.sh',
         'server/knex.sh',
     ];
+    if (details.presetDef.wantsMobile) {
+        scripts.push(
+            'scripts/bump-version.sh',
+            'scripts/prebuild.sh',
+            'scripts/run-ios.sh',
+            'scripts/release-android.sh',
+            'scripts/generate-icons.sh',
+            'scripts/install-native.sh'
+        );
+    }
 
     for (const script of scripts) {
         const scriptPath = path.join(outputDir, script);
@@ -309,25 +576,84 @@ export async function createProject() {
         }
     }
 
-    console.log(green('[4/5]') + ' Making scripts executable...');
+    console.log(green('[5/6]') + ' Making scripts executable...');
+
+    // [6/6] Manifest + git init
+    // Manifest captures sha256 of every file as it was generated +
+    // the user's prompt answers. `umpordez update <path>` reads it
+    // to know which files are user-edited vs untouched.
+    await writeInitialManifest({
+        projectDir: outputDir,
+        preset: details.preset,
+        details
+    });
 
-    // [5/5] Git init
     execSync('git init', { cwd: outputDir, stdio: 'ignore' });
-    console.log(green('[5/5]') + ' Initializing git repository...');
+    console.log(green('[6/6]') + ' Manifest + git init...');
 
     // Done!
     console.log('');
-    console.log(green.bold(`  \u2713 "${details.name}" created successfully!`));
+    console.log(green.bold(`  ✓ "${details.name}" created successfully!`));
     console.log('');
+    showNextSteps(details);
+}
+
+// Recursively rename any directory whose basename contains
+// {{PROJECT_SLUG}}. Walks bottom-up so renames don't invalidate the
+// queue.
+async function renameDirs(root, slug) {
+    const stack = [];
+    async function walk(dir) {
+        const entries = await fs.promises.readdir(dir, {
+            withFileTypes: true,
+        });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const fullPath = path.join(dir, entry.name);
+            await walk(fullPath);
+            stack.push(fullPath);
+        }
+    }
+    await walk(root);
+    for (const dirPath of stack) {
+        const basename = path.basename(dirPath);
+        if (basename.includes('{{PROJECT_SLUG}}')) {
+            const newPath = path.join(
+                path.dirname(dirPath),
+                basename.replaceAll('{{PROJECT_SLUG}}', slug)
+            );
+            await fs.promises.rename(dirPath, newPath);
+        }
+    }
+}
+
+function showNextSteps(details) {
+    const { presetDef } = details;
     console.log(chalk.bold('  Next steps:'));
     console.log(`  ${green('1.')} cd ${details.outputDir}`);
-    console.log(`  ${green('2.')} ./install.sh`);
-    console.log(`  ${green('3.')} ./seed.sh`);
-    console.log(`  ${green('4.')} ./dev.sh`);
+    if (presetDef.wantsServer) {
+        console.log(`  ${green('2.')} ./install.sh`);
+        console.log(`  ${green('3.')} ./seed.sh`);
+        console.log(`  ${green('4.')} ./dev.sh`);
+    } else {
+        console.log(`  ${green('2.')} cd mobile/${details.slug} && npm install`);
+        console.log(`  ${green('3.')} npm run start`);
+    }
     console.log('');
-    console.log(dim(`  Admin panel:  ${cyan(`http://localhost:${details.adminUiPort}`)}`));
-    console.log(dim(`  Admin API:    ${cyan(`http://localhost:${details.apiPort}`)}`));
-    console.log(dim(`  Site:         ${cyan(`http://localhost:${details.sitePort}`)}`));
+    if (presetDef.wantsAdminUi) {
+        console.log(dim(`  Admin panel:  ${cyan(`http://localhost:${details.adminUiPort}`)}`));
+    }
+    if (presetDef.wantsServer) {
+        console.log(dim(`  Admin API:    ${cyan(`http://localhost:${details.apiPort}`)}`));
+    }
+    if (presetDef.wantsSite) {
+        console.log(dim(`  Site:         ${cyan(`http://localhost:${details.sitePort}`)}`));
+    }
+    if (presetDef.wantsMobile) {
+        console.log(dim(`  Mobile:       cd mobile/${details.slug} && npm run ios | android | web`));
+    }
     console.log('');
     console.log(dim('  Happy hacking! - ') + cyan('youtube.com/ligeiro'));
     console.log('');