@aex.is/zero 0.1.6 → 0.1.7

package/README.md

@@ -1,6 +1,6 @@
 # Aexis Zero
 
-A cross-platform interactive CLI for scaffolding modern apps with a terminal UI.
+A cross-platform interactive CLI for scaffolding minimal Next.js and Expo apps with a terminal-first UI.
 
 ## Install (global)
 
@@ -24,9 +24,31 @@ zero
 
 - Bun installed and available on PATH.
 
+## Generated starters
+
+- Next.js App Router + Tailwind + shadcn-ready config.
+- Expo Router + Tamagui.
+- Minimal layout, three routes, metadata, and icon generation.
+- Contact form wired to `/api/contact` (Next) and mailto/endpoint fallback (Expo).
+
+## Environment variables
+
+The CLI generates `.env.example` with:
+- Next.js: `RESEND_API_KEY`, `EMAIL_FROM`, `EMAIL_TO`.
+- Expo: `EXPO_PUBLIC_CONTACT_EMAIL`, `EXPO_PUBLIC_CONTACT_ENDPOINT`.
+- Any selected module keys (Neon, Clerk, Payload, Stripe).
+
 ## Development
 
 ```sh
 bun install
 bun run dev
 ```
+
+### Build requirements
+
+- Go (for the Bubble Tea TUI binary build).
+- Brand assets in `assets/`:
+  - `assets/icon.svg`
+  - `assets/icon.png`
+  - `assets/social.png`

package/assets/icon.svg

@@ -0,0 +1,4 @@
+<svg width="900" height="900" viewBox="0 0 900 900" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="900" height="900" fill="#1E1E1E"/>
+<path d="M340.641 622.501L541.133 273.593L559.359 277.499L358.867 626.407L340.641 622.501ZM450 691.501C419.188 691.501 391.849 681.303 367.981 660.907C344.547 640.077 326.32 611.652 313.301 575.633C300.282 539.18 293.773 497.519 293.773 450.651C293.773 403.349 300.282 361.471 313.301 325.018C326.32 288.565 344.547 260.14 367.981 239.744C391.849 218.914 419.188 208.499 450 208.499C481.245 208.499 508.585 218.914 532.019 239.744C555.453 260.14 573.68 288.565 586.699 325.018C599.718 361.471 606.227 403.349 606.227 450.651C606.227 497.519 599.718 539.18 586.699 575.633C573.68 611.652 555.453 640.077 532.019 660.907C508.585 681.303 481.245 691.501 450 691.501ZM450 670.671C476.906 670.671 500.34 661.341 520.302 642.68C540.265 624.02 555.887 598.199 567.17 565.218C578.453 531.802 584.095 493.613 584.095 450.651C584.095 407.255 578.453 369.066 567.17 336.084C555.887 302.669 540.265 276.631 520.302 257.971C500.34 238.876 476.906 229.329 450 229.329C423.528 229.329 400.094 238.876 379.698 257.971C359.735 276.631 344.113 302.669 332.83 336.084C321.546 369.066 315.905 407.255 315.905 450.651C315.905 493.613 321.546 531.802 332.83 565.218C344.113 598.199 359.735 624.02 379.698 642.68C400.094 661.341 423.528 670.671 450 670.671Z" fill="#E7E5E4"/>
+</svg>

package/dist/cli/bubbletea.js

@@ -0,0 +1,57 @@
+import { execa } from 'execa';
+import path from 'path';
+import os from 'os';
+import { promises as fs } from 'fs';
+import { fileURLToPath } from 'url';
+export async function runWizard() {
+    const binPath = resolveTuiBinary();
+    try {
+        await fs.stat(binPath);
+    }
+    catch {
+        throw new Error(`TUI binary not found. Expected ${binPath}. Reinstall the CLI or run npm run build:tui.`);
+    }
+    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'aexis-zero-'));
+    const outputPath = path.join(tmpDir, 'result.json');
+    try {
+        await execa(binPath, ['-output', outputPath], {
+            stdio: 'inherit',
+            shell: false
+        });
+    }
+    catch (error) {
+        return null;
+    }
+    try {
+        const content = await fs.readFile(outputPath, 'utf8');
+        if (!content.trim()) {
+            return null;
+        }
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function resolveTuiBinary() {
+    const platform = process.platform;
+    const arch = process.arch;
+    let target = '';
+    if (platform === 'darwin') {
+        target = arch === 'arm64' ? 'darwin-arm64' : 'darwin-amd64';
+    }
+    else if (platform === 'linux') {
+        target = arch === 'arm64' ? 'linux-arm64' : 'linux-amd64';
+    }
+    else if (platform === 'win32') {
+        target = 'windows-amd64';
+    }
+    else {
+        throw new Error(`Unsupported platform: ${platform}`);
+    }
+    const exe = platform === 'win32' ? '.exe' : '';
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    const binDir = path.resolve(currentDir, '..', '..', 'bin');
+    const binPath = path.join(binDir, `zero-${target}${exe}`);
+    return binPath;
+}

package/dist/config/base-env.js

@@ -0,0 +1,31 @@
+const nextBaseEnv = [
+    {
+        key: 'RESEND_API_KEY',
+        description: 'Resend API key',
+        url: 'https://resend.com'
+    },
+    {
+        key: 'EMAIL_FROM',
+        description: 'Verified sender email address'
+    },
+    {
+        key: 'EMAIL_TO',
+        description: 'Destination email address'
+    }
+];
+const expoBaseEnv = [
+    {
+        key: 'EXPO_PUBLIC_CONTACT_EMAIL',
+        description: 'Email address used for contact form'
+    },
+    {
+        key: 'EXPO_PUBLIC_CONTACT_ENDPOINT',
+        description: 'Optional contact API endpoint'
+    }
+];
+export function getBaseEnvHelp(framework) {
+    return framework === 'nextjs' ? nextBaseEnv : expoBaseEnv;
+}
+export function getBaseEnvVars(framework) {
+    return getBaseEnvHelp(framework).map((item) => item.key);
+}

package/dist/config/frameworks.js

@@ -7,6 +7,7 @@ export const frameworks = [
             'class-variance-authority',
             'clsx',
             'lucide-react',
+            'resend',
             'tailwind-merge',
             'tailwindcss-animate',
             '@radix-ui/react-slot'

package/dist/engine/assets.js

@@ -0,0 +1,54 @@
+import path from 'path';
+import { promises as fs } from 'fs';
+import { fileURLToPath } from 'url';
+import sharp from 'sharp';
+export function resolveAssetSources() {
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    const rootDir = path.resolve(currentDir, '..', '..');
+    const assetsDir = path.join(rootDir, 'assets');
+    return {
+        iconSvg: path.join(assetsDir, 'icon.svg'),
+        iconPng: path.join(assetsDir, 'icon.png'),
+        socialPng: path.join(assetsDir, 'social.png')
+    };
+}
+export async function assertAssetSources(sources) {
+    const missing = [];
+    for (const [key, value] of Object.entries(sources)) {
+        try {
+            await fs.stat(value);
+        }
+        catch {
+            missing.push(`${key}: ${value}`);
+        }
+    }
+    if (missing.length > 0) {
+        throw new Error(`Missing asset files. Add them to the CLI package under /assets:\n${missing.join('\n')}`);
+    }
+}
+export async function generateNextAssets(sources, targets) {
+    await fs.mkdir(targets.appDir, { recursive: true });
+    await fs.mkdir(targets.publicDir, { recursive: true });
+    await fs.copyFile(sources.iconSvg, path.join(targets.appDir, 'icon.svg'));
+    await resizePng(sources.iconPng, path.join(targets.appDir, 'apple-icon.png'), 180, 180);
+    await resizePng(sources.socialPng, path.join(targets.appDir, 'opengraph-image.png'), 1200, 630);
+    await resizePng(sources.socialPng, path.join(targets.appDir, 'twitter-image.png'), 1200, 630);
+    await resizePng(sources.iconPng, path.join(targets.publicDir, 'favicon-16x16.png'), 16, 16);
+    await resizePng(sources.iconPng, path.join(targets.publicDir, 'favicon-32x32.png'), 32, 32);
+    await resizePng(sources.iconPng, path.join(targets.publicDir, 'apple-touch-icon.png'), 180, 180);
+    await resizePng(sources.iconPng, path.join(targets.publicDir, 'android-chrome-192x192.png'), 192, 192);
+    await resizePng(sources.iconPng, path.join(targets.publicDir, 'android-chrome-512x512.png'), 512, 512);
+}
+export async function generateExpoAssets(sources, targets) {
+    await fs.mkdir(targets.assetsDir, { recursive: true });
+    await resizePng(sources.iconPng, path.join(targets.assetsDir, 'icon.png'), 1024, 1024);
+    await resizePng(sources.iconPng, path.join(targets.assetsDir, 'adaptive-icon.png'), 1024, 1024);
+    await resizePng(sources.iconPng, path.join(targets.assetsDir, 'favicon.png'), 48, 48);
+    await resizePng(sources.socialPng, path.join(targets.assetsDir, 'splash.png'), 1200, 630);
+}
+async function resizePng(source, destination, width, height) {
+    await sharp(source)
+        .resize(width, height, { fit: 'cover' })
+        .png()
+        .toFile(destination);
+}

package/dist/engine/env.js

@@ -1,9 +1,11 @@
 import path from 'path';
 import { promises as fs } from 'fs';
+import { getBaseEnvVars } from '../config/base-env.js';
 import { getModuleEnvVars } from '../config/modules.js';
-export async function writeEnvExample(moduleIds, targetDir) {
-    const envVars = getModuleEnvVars(moduleIds);
-    const lines = envVars.map((key) => `${key}=`);
+export async function writeEnvExample(moduleIds, framework, targetDir) {
+    const envVars = [...getBaseEnvVars(framework), ...getModuleEnvVars(moduleIds)];
+    const unique = Array.from(new Set(envVars));
+    const lines = unique.map((key) => `${key}=`);
     const content = lines.length > 0 ? `${lines.join('\n')}\n` : '';
     const envPath = path.join(targetDir, '.env.example');
     await fs.writeFile(envPath, content, 'utf8');

package/dist/engine/scaffold.js

@@ -2,9 +2,11 @@ import path from 'path';
 import { promises as fs } from 'fs';
 import { execa } from 'execa';
 import { getFrameworkDefinition } from '../config/frameworks.js';
+import { getBaseEnvHelp } from '../config/base-env.js';
 import { getModuleEnvHelp } from '../config/modules.js';
 import { installBaseDependencies, installModulePackages } from './installers.js';
 import { writeEnvExample } from './env.js';
+import { assertAssetSources, generateExpoAssets, generateNextAssets, resolveAssetSources } from './assets.js';
 import { buildNextTemplateFiles, buildExpoTemplateFiles, componentsJsonTemplate } from './templates.js';
 const baseEnv = {
     ...process.env,
@@ -15,6 +17,8 @@ export async function scaffoldProject(config) {
     const targetDir = path.resolve(process.cwd(), directoryInput);
     await ensureEmptyTargetDir(targetDir);
     const framework = getFrameworkDefinition(config.framework);
+    const sources = resolveAssetSources();
+    await assertAssetSources(sources);
     console.log(`Scaffolding ${framework.label}...`);
     await runScaffoldCommand(framework.scaffold.command, framework.scaffold.packageName, directoryInput, framework.scaffold.argSets);
     console.log('Applying framework templates...');
@@ -24,12 +28,29 @@ export async function scaffoldProject(config) {
     else {
         await applyExpoTemplates(config, targetDir);
     }
+    console.log('Generating brand assets...');
+    if (config.framework === 'nextjs') {
+        const usesSrcDir = await pathExists(path.join(targetDir, 'src', 'app'));
+        const appDir = usesSrcDir ? path.join(targetDir, 'src', 'app') : path.join(targetDir, 'app');
+        await generateNextAssets(sources, {
+            appDir,
+            publicDir: path.join(targetDir, 'public'),
+            assetsDir: path.join(targetDir, 'assets')
+        });
+    }
+    else {
+        await generateExpoAssets(sources, {
+            appDir: path.join(targetDir, 'app'),
+            publicDir: path.join(targetDir, 'public'),
+            assetsDir: path.join(targetDir, 'assets')
+        });
+    }
     console.log('Installing base dependencies with Bun...');
     await installBaseDependencies(targetDir, framework.packages);
     console.log('Installing module packages...');
     await installModulePackages(config.framework, config.modules, targetDir);
     console.log('Generating .env.example...');
-    await writeEnvExample(config.modules, targetDir);
+    await writeEnvExample(config.modules, config.framework, targetDir);
     console.log('Scaffold complete.');
     const cdTarget = directoryInput === '.' ? '.' : directoryInput.includes(' ') ? `"${directoryInput}"` : directoryInput;
     console.log(`\nNext steps:\n  1) cd ${cdTarget}\n  2) bun run dev`);
@@ -79,7 +100,7 @@ async function applyNextTemplates(config, targetDir) {
     const srcAppDir = path.join(targetDir, 'src', 'app');
     const usesSrcDir = await pathExists(srcAppDir);
     const basePath = usesSrcDir ? 'src' : '';
-    const envHelp = getModuleEnvHelp(config.modules);
+    const envHelp = mergeEnvHelp(getBaseEnvHelp(config.framework), getModuleEnvHelp(config.modules));
     const files = buildNextTemplateFiles({
         appName: config.appName,
         domain: config.domain,
@@ -95,7 +116,7 @@ async function applyNextTemplates(config, targetDir) {
     await ensurePackageName(targetDir, config.appName);
 }
 async function applyExpoTemplates(config, targetDir) {
-    const envHelp = getModuleEnvHelp(config.modules);
+    const envHelp = mergeEnvHelp(getBaseEnvHelp(config.framework), getModuleEnvHelp(config.modules));
     const files = buildExpoTemplateFiles({
         appName: config.appName,
         domain: config.domain,
@@ -114,6 +135,12 @@ async function ensureExpoConfig(targetDir, appName) {
     }
     appJson.expo.name = appName;
     appJson.expo.slug = toSlug(appName);
+    appJson.expo.icon = './assets/icon.png';
+    appJson.expo.splash = {
+        image: './assets/splash.png',
+        resizeMode: 'contain',
+        backgroundColor: '#E7E5E4'
+    };
     if (!Array.isArray(appJson.expo.platforms)) {
         appJson.expo.platforms = ['ios', 'android', 'macos', 'windows'];
     }
@@ -128,6 +155,24 @@ async function ensureExpoConfig(targetDir, appName) {
         const current = appJson.expo.plugins.filter((value) => typeof value === 'string');
         appJson.expo.plugins = mergeUnique(current, ['expo-router']);
     }
+    if (!appJson.expo.android || typeof appJson.expo.android !== 'object') {
+        appJson.expo.android = {};
+    }
+    appJson.expo.android.adaptiveIcon = {
+        foregroundImage: './assets/adaptive-icon.png',
+        backgroundColor: '#E7E5E4'
+    };
+    if (!appJson.expo.ios || typeof appJson.expo.ios !== 'object') {
+        appJson.expo.ios = {};
+    }
+    appJson.expo.ios.icon = './assets/icon.png';
+    if (!appJson.expo.web || typeof appJson.expo.web !== 'object') {
+        appJson.expo.web = {};
+    }
+    appJson.expo.web.favicon = './assets/favicon.png';
+    if (!Array.isArray(appJson.expo.assetBundlePatterns)) {
+        appJson.expo.assetBundlePatterns = ['**/*'];
+    }
     await writeJson(appJsonPath, appJson);
     const packageJsonPath = path.join(targetDir, 'package.json');
     const packageJson = await readJson(packageJsonPath, {});
@@ -164,6 +209,17 @@ async function ensureNextTurbo(targetDir) {
     }
     await writeJson(packageJsonPath, packageJson);
 }
+function mergeEnvHelp(...lists) {
+    const map = new Map();
+    for (const list of lists) {
+        for (const item of list) {
+            if (!map.has(item.key)) {
+                map.set(item.key, item);
+            }
+        }
+    }
+    return Array.from(map.values());
+}
 async function ensurePackageName(targetDir, appName) {
     const packageJsonPath = path.join(targetDir, 'package.json');
     const packageJson = await readJson(packageJsonPath, {});