@aex.is/zero 0.1.3 → 0.1.5

package/dist/cli/prompts.js

@@ -0,0 +1,163 @@
+import * as p from '@clack/prompts';
+import { frameworks } from '../config/frameworks.js';
+import { modules } from '../config/modules.js';
+const introArt = [
+    '   _____',
+    '  / ___ \\\\',
+    ' / / _ \\\\ \\\\',
+    ' | |/ /| |',
+    ' \\\\ \\\\_/ / /',
+    '  \\\\___/_/'
+].join('\n');
+export async function runWizard() {
+    p.intro(`${introArt}\nAexis Zero`);
+    let directory = '.';
+    let appName = '';
+    let domain = '';
+    let framework = 'nextjs';
+    let selectedModules = [];
+    let step = 'directory';
+    while (true) {
+        if (step === 'directory') {
+            const value = await p.text({
+                message: 'Project directory',
+                placeholder: '.',
+                validate: (input) => {
+                    if (typeof input !== 'string') {
+                        return 'Enter a directory.';
+                    }
+                    return undefined;
+                }
+            });
+            if (isCancelled(value))
+                return null;
+            const normalized = String(value).trim();
+            directory = normalized.length === 0 ? '.' : normalized;
+            step = 'name';
+            continue;
+        }
+        if (step === 'name') {
+            const value = await p.text({
+                message: 'App name',
+                placeholder: 'my-app',
+                validate: (input) => {
+                    if (typeof input !== 'string' || input.trim().length === 0) {
+                        return 'App name is required.';
+                    }
+                    return undefined;
+                }
+            });
+            if (isCancelled(value))
+                return null;
+            appName = String(value).trim();
+            step = 'domain';
+            continue;
+        }
+        if (step === 'domain') {
+            const value = await p.text({
+                message: 'Domain (optional)',
+                placeholder: 'example.com'
+            });
+            if (isCancelled(value))
+                return null;
+            domain = String(value).trim();
+            step = 'framework';
+            continue;
+        }
+        if (step === 'framework') {
+            const value = await p.select({
+                message: 'Framework',
+                options: frameworks.map((item) => ({
+                    value: item.id,
+                    label: item.label,
+                    hint: item.description
+                }))
+            });
+            if (isCancelled(value))
+                return null;
+            framework = value;
+            step = 'modules';
+            continue;
+        }
+        if (step === 'modules') {
+            const value = await p.multiselect({
+                message: 'Modules',
+                options: modules.map((item) => ({
+                    value: item.id,
+                    label: item.label,
+                    hint: item.description
+                })),
+                required: false
+            });
+            if (isCancelled(value))
+                return null;
+            selectedModules = value;
+            step = 'confirm';
+            continue;
+        }
+        if (step === 'confirm') {
+            const frameworkLabel = frameworks.find((item) => item.id === framework)?.label ?? framework;
+            const moduleLabels = selectedModules
+                .map((id) => modules.find((item) => item.id === id)?.label ?? id)
+                .join(', ');
+            p.note([
+                `Directory: ${directory}`,
+                `App name: ${appName}`,
+                `Domain: ${domain || 'None'}`,
+                `Framework: ${frameworkLabel}`,
+                `Modules: ${moduleLabels || 'None'}`
+            ].join('\n'), 'Review');
+            const action = await p.select({
+                message: 'Next step',
+                options: [
+                    { value: 'continue', label: 'Continue' },
+                    { value: 'edit-directory', label: 'Edit directory' },
+                    { value: 'edit-name', label: 'Edit name' },
+                    { value: 'edit-domain', label: 'Edit domain' },
+                    { value: 'edit-framework', label: 'Edit framework' },
+                    { value: 'edit-modules', label: 'Edit modules' },
+                    { value: 'cancel', label: 'Cancel' }
+                ]
+            });
+            if (isCancelled(action))
+                return null;
+            switch (action) {
+                case 'continue':
+                    return {
+                        directory,
+                        appName,
+                        domain,
+                        framework,
+                        modules: selectedModules
+                    };
+                case 'edit-directory':
+                    step = 'directory';
+                    continue;
+                case 'edit-name':
+                    step = 'name';
+                    continue;
+                case 'edit-domain':
+                    step = 'domain';
+                    continue;
+                case 'edit-framework':
+                    step = 'framework';
+                    continue;
+                case 'edit-modules':
+                    step = 'modules';
+                    continue;
+                case 'cancel':
+                    p.cancel('Cancelled.');
+                    return null;
+                default:
+                    return null;
+            }
+        }
+    }
+}
+function isCancelled(value) {
+    if (p.isCancel(value)) {
+        p.cancel('Cancelled.');
+        return true;
+    }
+    return false;
+}

package/dist/config/frameworks.js

@@ -66,6 +66,8 @@ export const frameworks = [
         description: 'Expo app with Router and EAS configuration.',
         packages: [
             'expo-router',
+            'expo-font',
+            '@expo-google-fonts/geist-mono',
             'tamagui',
             '@tamagui/config',
             '@tamagui/animations-react-native',

package/dist/config/modules.js

@@ -3,7 +3,13 @@ export const modules = [
         id: 'neon',
         label: 'Database (Neon)',
         description: 'Serverless Postgres with Neon.',
-        envVars: ['DATABASE_URL'],
+        envVars: [
+            {
+                key: 'DATABASE_URL',
+                description: 'Neon connection string',
+                url: 'https://neon.com/docs/get-started/connect-neon'
+            }
+        ],
         packages: {
             nextjs: ['@neondatabase/serverless'],
             expo: ['@neondatabase/serverless']
@@ -13,7 +19,18 @@ export const modules = [
         id: 'clerk',
         label: 'Auth (Clerk)',
         description: 'Authentication with Clerk.',
-        envVars: ['CLERK_PUBLISHABLE_KEY', 'CLERK_SECRET_KEY'],
+        envVars: [
+            {
+                key: 'CLERK_PUBLISHABLE_KEY',
+                description: 'Clerk publishable key',
+                url: 'https://dashboard.clerk.com'
+            },
+            {
+                key: 'CLERK_SECRET_KEY',
+                description: 'Clerk secret key',
+                url: 'https://dashboard.clerk.com'
+            }
+        ],
         packages: {
             nextjs: ['@clerk/nextjs'],
             expo: ['@clerk/clerk-expo']
@@ -23,7 +40,18 @@ export const modules = [
         id: 'payload',
         label: 'CMS (Payload)',
         description: 'Headless CMS using Payload.',
-        envVars: ['PAYLOAD_SECRET', 'DATABASE_URL'],
+        envVars: [
+            {
+                key: 'PAYLOAD_SECRET',
+                description: 'Payload secret (generate a long random string)',
+                url: 'https://payloadcms.com/docs'
+            },
+            {
+                key: 'DATABASE_URL',
+                description: 'Database connection string',
+                url: 'https://payloadcms.com/docs'
+            }
+        ],
         packages: {
             nextjs: ['payload'],
             expo: ['payload']
@@ -33,7 +61,18 @@ export const modules = [
         id: 'stripe',
         label: 'Payments (Stripe)',
         description: 'Payments via Stripe SDK.',
-        envVars: ['STRIPE_SECRET_KEY', 'STRIPE_WEBHOOK_SECRET'],
+        envVars: [
+            {
+                key: 'STRIPE_SECRET_KEY',
+                description: 'Stripe secret key',
+                url: 'https://dashboard.stripe.com/apikeys'
+            },
+            {
+                key: 'STRIPE_WEBHOOK_SECRET',
+                description: 'Stripe webhook signing secret',
+                url: 'https://dashboard.stripe.com/webhooks'
+            }
+        ],
         packages: {
             nextjs: ['stripe'],
             expo: ['stripe']
@@ -62,8 +101,20 @@ export function getModuleEnvVars(moduleIds) {
     for (const id of moduleIds) {
         const module = getModuleDefinition(id);
         for (const envVar of module.envVars) {
-            envVars.add(envVar);
+            envVars.add(envVar.key);
         }
     }
     return Array.from(envVars).sort();
 }
+export function getModuleEnvHelp(moduleIds) {
+    const map = new Map();
+    for (const id of moduleIds) {
+        const module = getModuleDefinition(id);
+        for (const envVar of module.envVars) {
+            if (!map.has(envVar.key)) {
+                map.set(envVar.key, envVar);
+            }
+        }
+    }
+    return Array.from(map.values());
+}

package/dist/engine/scaffold.js

@@ -2,25 +2,27 @@ import path from 'path';
 import { promises as fs } from 'fs';
 import { execa } from 'execa';
 import { getFrameworkDefinition } from '../config/frameworks.js';
+import { getModuleEnvHelp } from '../config/modules.js';
 import { installBaseDependencies, installModulePackages } from './installers.js';
 import { writeEnvExample } from './env.js';
-import { nextLayoutTemplate, nextPageTemplate, shadcnUtilsTemplate, componentsJsonTemplate, tamaguiConfigTemplate, metroConfigTemplate, expoLayoutTemplate, expoIndexTemplate } from './templates.js';
+import { buildNextTemplateFiles, buildExpoTemplateFiles, componentsJsonTemplate } from './templates.js';
 const baseEnv = {
     ...process.env,
     CI: '1'
 };
 export async function scaffoldProject(config) {
-    const targetDir = path.resolve(process.cwd(), config.appName);
+    const directoryInput = config.directory.trim().length === 0 ? '.' : config.directory.trim();
+    const targetDir = path.resolve(process.cwd(), directoryInput);
     await ensureEmptyTargetDir(targetDir);
     const framework = getFrameworkDefinition(config.framework);
     console.log(`Scaffolding ${framework.label}...`);
-    await runScaffoldCommand(framework.scaffold.command, framework.scaffold.packageName, config.appName, framework.scaffold.argSets);
+    await runScaffoldCommand(framework.scaffold.command, framework.scaffold.packageName, directoryInput, framework.scaffold.argSets);
     console.log('Applying framework templates...');
     if (config.framework === 'nextjs') {
-        await applyNextTemplates(targetDir);
+        await applyNextTemplates(config, targetDir);
     }
     else {
-        await applyExpoTemplates(targetDir);
+        await applyExpoTemplates(config, targetDir);
     }
     console.log('Installing base dependencies with Bun...');
     await installBaseDependencies(targetDir, framework.packages);
@@ -29,7 +31,7 @@ export async function scaffoldProject(config) {
     console.log('Generating .env.example...');
     await writeEnvExample(config.modules, targetDir);
     console.log('Scaffold complete.');
-    const cdTarget = config.appName.includes(' ') ? `"${config.appName}"` : config.appName;
+    const cdTarget = directoryInput === '.' ? '.' : directoryInput.includes(' ') ? `"${directoryInput}"` : directoryInput;
     console.log(`\nNext steps:\n  1) cd ${cdTarget}\n  2) bun run dev`);
 }
 async function ensureEmptyTargetDir(targetDir) {
@@ -50,11 +52,12 @@ async function ensureEmptyTargetDir(targetDir) {
         throw error;
     }
 }
-async function runScaffoldCommand(command, packageName, appName, argSets) {
+async function runScaffoldCommand(command, packageName, directoryInput, argSets) {
     const errors = [];
+    const targetArg = directoryInput === '.' ? '.' : directoryInput;
     for (const args of argSets) {
         try {
-            await execa(command, [packageName, appName, ...args], {
+            await execa(command, [packageName, targetArg, ...args], {
                 stdio: 'inherit',
                 env: baseEnv,
                 shell: false
@@ -70,32 +73,45 @@ async function runScaffoldCommand(command, packageName, appName, argSets) {
         : 'Scaffold failed for unknown reasons.';
     throw new Error(message);
 }
-async function applyNextTemplates(targetDir) {
-    const rootAppDir = path.join(targetDir, 'app');
+async function applyNextTemplates(config, targetDir) {
     const srcAppDir = path.join(targetDir, 'src', 'app');
     const usesSrcDir = await pathExists(srcAppDir);
-    const appDir = usesSrcDir ? srcAppDir : rootAppDir;
-    const projectSrcBase = usesSrcDir ? path.join(targetDir, 'src') : targetDir;
-    await fs.mkdir(appDir, { recursive: true });
-    await fs.writeFile(path.join(appDir, 'layout.tsx'), nextLayoutTemplate, 'utf8');
-    await fs.writeFile(path.join(appDir, 'page.tsx'), nextPageTemplate, 'utf8');
-    await ensureShadcnSetup(targetDir, projectSrcBase, usesSrcDir);
+    const basePath = usesSrcDir ? 'src' : '';
+    const envHelp = getModuleEnvHelp(config.modules);
+    const files = buildNextTemplateFiles({
+        appName: config.appName,
+        domain: config.domain,
+        envVars: envHelp,
+        basePath
+    });
+    await writeTemplateFiles(targetDir, files);
+    const globalsPath = usesSrcDir ? 'src/app/globals.css' : 'app/globals.css';
+    const tailwindConfig = await detectTailwindConfig(targetDir);
+    const componentsJson = componentsJsonTemplate(globalsPath, tailwindConfig ?? 'tailwind.config.ts');
+    await fs.writeFile(path.join(targetDir, 'components.json'), componentsJson, 'utf8');
     await ensureNextTurbo(targetDir);
-}
-async function applyExpoTemplates(targetDir) {
-    const appDir = path.join(targetDir, 'app');
-    await fs.mkdir(appDir, { recursive: true });
-    await fs.writeFile(path.join(appDir, '_layout.tsx'), expoLayoutTemplate, 'utf8');
-    await fs.writeFile(path.join(appDir, 'index.tsx'), expoIndexTemplate, 'utf8');
-    await ensureExpoConfig(targetDir);
-    await ensureExpoTamagui(targetDir);
-}
-async function ensureExpoConfig(targetDir) {
+    await ensurePackageName(targetDir, config.appName);
+}
+async function applyExpoTemplates(config, targetDir) {
+    const envHelp = getModuleEnvHelp(config.modules);
+    const files = buildExpoTemplateFiles({
+        appName: config.appName,
+        domain: config.domain,
+        envVars: envHelp,
+        basePath: ''
+    });
+    await writeTemplateFiles(targetDir, files);
+    await ensureExpoConfig(targetDir, config.appName);
+    await ensurePackageName(targetDir, config.appName);
+}
+async function ensureExpoConfig(targetDir, appName) {
     const appJsonPath = path.join(targetDir, 'app.json');
     const appJson = await readJson(appJsonPath, { expo: {} });
     if (!appJson.expo || typeof appJson.expo !== 'object') {
         appJson.expo = {};
     }
+    appJson.expo.name = appName;
+    appJson.expo.slug = toSlug(appName);
     if (!Array.isArray(appJson.expo.platforms)) {
         appJson.expo.platforms = ['ios', 'android', 'macos', 'windows'];
     }
@@ -134,6 +150,31 @@ async function ensureExpoConfig(targetDir) {
     };
     await writeJson(easPath, easConfig);
 }
+async function ensureNextTurbo(targetDir) {
+    const packageJsonPath = path.join(targetDir, 'package.json');
+    const packageJson = await readJson(packageJsonPath, {});
+    if (!packageJson.scripts || typeof packageJson.scripts !== 'object') {
+        packageJson.scripts = {};
+    }
+    const currentDev = typeof packageJson.scripts.dev === 'string' ? packageJson.scripts.dev : 'next dev';
+    if (!currentDev.includes('--turbo')) {
+        packageJson.scripts.dev = `${currentDev} --turbo`;
+    }
+    await writeJson(packageJsonPath, packageJson);
+}
+async function ensurePackageName(targetDir, appName) {
+    const packageJsonPath = path.join(targetDir, 'package.json');
+    const packageJson = await readJson(packageJsonPath, {});
+    packageJson.name = toPackageName(appName);
+    await writeJson(packageJsonPath, packageJson);
+}
+async function writeTemplateFiles(targetDir, files) {
+    for (const file of files) {
+        const fullPath = path.join(targetDir, ...file.path.split('/'));
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, file.content, 'utf8');
+    }
+}
 function mergeUnique(values, additions) {
     const set = new Set(values);
     for (const value of additions) {
@@ -141,6 +182,21 @@ function mergeUnique(values, additions) {
     }
     return Array.from(set);
 }
+async function detectTailwindConfig(targetDir) {
+    const candidates = [
+        'tailwind.config.ts',
+        'tailwind.config.js',
+        'tailwind.config.cjs',
+        'tailwind.config.mjs'
+    ];
+    for (const filename of candidates) {
+        const fullPath = path.join(targetDir, filename);
+        if (await pathExists(fullPath)) {
+            return filename;
+        }
+    }
+    return null;
+}
 async function readJson(filePath, fallback) {
     try {
         const data = await fs.readFile(filePath, 'utf8');
@@ -178,74 +234,20 @@ async function pathExists(targetPath) {
         throw error;
     }
 }
-async function ensureNextTurbo(targetDir) {
-    const packageJsonPath = path.join(targetDir, 'package.json');
-    const packageJson = await readJson(packageJsonPath, {});
-    if (!packageJson.scripts || typeof packageJson.scripts !== 'object') {
-        packageJson.scripts = {};
-    }
-    const currentDev = typeof packageJson.scripts.dev === 'string' ? packageJson.scripts.dev : 'next dev';
-    if (!currentDev.includes('--turbo')) {
-        packageJson.scripts.dev = `${currentDev} --turbo`;
-    }
-    await writeJson(packageJsonPath, packageJson);
-}
-async function ensureShadcnSetup(targetDir, projectSrcBase, usesSrcDir) {
-    const libDir = path.join(projectSrcBase, 'lib');
-    await fs.mkdir(libDir, { recursive: true });
-    await fs.writeFile(path.join(libDir, 'utils.ts'), shadcnUtilsTemplate, 'utf8');
-    const globalsPath = usesSrcDir ? 'src/app/globals.css' : 'app/globals.css';
-    const tailwindConfigPath = await detectTailwindConfig(targetDir);
-    const componentsJson = componentsJsonTemplate(globalsPath, tailwindConfigPath ?? 'tailwind.config.ts');
-    await fs.writeFile(path.join(targetDir, 'components.json'), componentsJson, 'utf8');
-}
-async function detectTailwindConfig(targetDir) {
-    const candidates = [
-        'tailwind.config.ts',
-        'tailwind.config.js',
-        'tailwind.config.cjs',
-        'tailwind.config.mjs'
-    ];
-    for (const filename of candidates) {
-        const fullPath = path.join(targetDir, filename);
-        if (await pathExists(fullPath)) {
-            return filename;
-        }
-    }
-    return null;
-}
-async function ensureExpoTamagui(targetDir) {
-    const configPath = path.join(targetDir, 'tamagui.config.ts');
-    await fs.writeFile(configPath, tamaguiConfigTemplate, 'utf8');
-    const metroPath = path.join(targetDir, 'metro.config.js');
-    await fs.writeFile(metroPath, metroConfigTemplate, 'utf8');
-    await ensureBabelTamagui(targetDir);
-}
-async function ensureBabelTamagui(targetDir) {
-    const babelPath = path.join(targetDir, 'babel.config.js');
-    let content = '';
-    if (await pathExists(babelPath)) {
-        content = await fs.readFile(babelPath, 'utf8');
-    }
-    if (!content) {
-        const defaultConfig = `module.exports = function (api) {\n  api.cache(true);\n  return {\n    presets: ['babel-preset-expo'],\n    plugins: [\n      'expo-router/babel',\n      [\n        '@tamagui/babel-plugin',\n        {\n          config: './tamagui.config.ts',\n          components: ['tamagui']\n        }\n      ]\n    ]\n  };\n};\n`;
-        await fs.writeFile(babelPath, defaultConfig, 'utf8');
-        return;
-    }
-    if (content.includes('@tamagui/babel-plugin')) {
-        return;
-    }
-    const pluginSnippet = `[\n        '@tamagui/babel-plugin',\n        {\n          config: './tamagui.config.ts',\n          components: ['tamagui']\n        }\n      ]`;
-    const pluginsRegex = /plugins:\\s*\\[(.*)\\]/s;
-    if (pluginsRegex.test(content)) {
-        content = content.replace(pluginsRegex, (match, inner) => {
-            const trimmed = inner.trim();
-            const updatedInner = trimmed.length > 0 ? `${trimmed},\n      ${pluginSnippet}` : pluginSnippet;
-            return `plugins: [${updatedInner}]`;
-        });
-    }
-    else {
-        content = content.replace(/return\\s*\\{/, (match) => `${match}\n    plugins: [${pluginSnippet}],`);
-    }
-    await fs.writeFile(babelPath, content, 'utf8');
+function toPackageName(name) {
+    const cleaned = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-._]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^[-_.]+|[-_.]+$/g, '');
+    return cleaned || 'aexis-zero-app';
+}
+function toSlug(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '') || 'aexis-zero-app';
 }