@tanstack/cta-engine 0.14.3 → 0.15.0

package/dist/create-app.js

@@ -1,491 +1,182 @@
-import { basename, dirname, resolve } from 'node:path';
-import { log, outro, spinner } from '@clack/prompts';
-import { render } from 'ejs';
-import { format } from 'prettier';
-import chalk from 'chalk';
-import { getTemplatesRoot } from './templates.js';
-import { CODE_ROUTER, FILE_ROUTER } from './constants.js';
-import { sortObject } from './utils.js';
-import { writeConfigFile } from './config-file.js';
-import { packageManagerExecute } from './package-manager.js';
-import { getBinaryFile } from './file-helper.js';
-function createCopyFiles(environment, targetDir) {
-    return async function copyFiles(templateDir, files, 
-    // optionally copy files from a folder to the root
-    toRoot) {
+import { basename, resolve } from 'node:path';
+import { isBase64 } from './file-helpers.js';
+import { formatCommand } from './utils.js';
+import { writeConfigFileToEnvironment } from './config-file.js';
+import { getPackageManagerScriptCommand, packageManagerInstall, } from './package-manager.js';
+import { createPackageJSON } from './package-json.js';
+import { createTemplateFile } from './template-file.js';
+import { installShadcnComponents } from './integrations/shadcn.js';
+import { setupGit } from './integrations/git.js';
+import { runSpecialSteps } from './special-steps/index.js';
+async function writeFiles(environment, options) {
+    const templateFileFromContent = createTemplateFile(environment, options);
+    async function writeFileBundle(bundle) {
+        const files = await bundle.getFiles();
         for (const file of files) {
-            let targetFileName = file.replace('.tw', '');
-            if (toRoot) {
-                const fileNoPath = targetFileName.split('/').pop();
-                targetFileName = fileNoPath ? `./${fileNoPath}` : targetFileName;
+            const contents = await bundle.getFileContents(file);
+            const isBinaryFile = isBase64(contents);
+            if (isBinaryFile) {
+                await environment.writeFileBase64(resolve(options.targetDir, file), contents);
             }
-            await environment.copyFile(resolve(templateDir, file), resolve(targetDir, targetFileName));
-        }
-    };
-}
-function jsSafeName(name) {
-    return name
-        .split(/[^a-zA-Z0-9]/)
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join('');
-}
-function createTemplateFile(environment, projectName, options, targetDir) {
-    return async function templateFile(file, content, targetFileName, extraTemplateValues) {
-        function getPackageManagerAddScript(packageName, isDev = false) {
-            let command;
-            switch (options.packageManager) {
-                case 'yarn':
-                case 'pnpm':
-                    command = isDev
-                        ? `${options.packageManager} add ${packageName} --dev`
-                        : `${options.packageManager} add ${packageName}`;
-                    break;
-                default:
-                    command = isDev
-                        ? `${options.packageManager} install ${packageName} -D`
-                        : `${options.packageManager} install ${packageName}`;
-                    break;
-            }
-            return command;
-        }
-        function getPackageManagerRunScript(scriptName) {
-            let command;
-            switch (options.packageManager) {
-                case 'yarn':
-                case 'pnpm':
-                    command = `${options.packageManager} ${scriptName}`;
-                    break;
-                case 'deno':
-                    command = `${options.packageManager} task ${scriptName}`;
-                    break;
-                default:
-                    command = `${options.packageManager} run ${scriptName}`;
-                    break;
-            }
-            return command;
-        }
-        const templateValues = {
-            packageManager: options.packageManager,
-            projectName: projectName,
-            typescript: options.typescript,
-            tailwind: options.tailwind,
-            toolchain: options.toolchain,
-            js: options.typescript ? 'ts' : 'js',
-            jsx: options.typescript ? 'tsx' : 'jsx',
-            fileRouter: options.mode === FILE_ROUTER,
-            codeRouter: options.mode === CODE_ROUTER,
-            addOnEnabled: options.chosenAddOns.reduce((acc, addOn) => {
-                acc[addOn.id] = true;
-                return acc;
-            }, {}),
-            addOns: options.chosenAddOns,
-            ...extraTemplateValues,
-            getPackageManagerAddScript,
-            getPackageManagerRunScript,
-        };
-        try {
-            content = render(content, templateValues);
-        }
-        catch (error) {
-            console.error(chalk.red(`EJS error in file ${file}`));
-            console.error(error);
-            process.exit(1);
-        }
-        const target = targetFileName ?? file.replace('.ejs', '');
-        if (target.endsWith('.ts') || target.endsWith('.tsx')) {
-            content = await format(content, {
-                semi: false,
-                singleQuote: true,
-                trailingComma: 'all',
-                parser: 'typescript',
-            });
-        }
-        await environment.writeFile(resolve(targetDir, target), content);
-    };
-}
-async function createPackageJSON(environment, projectName, options, templateDir, routerDir, targetDir, addOns) {
-    let packageJSON = JSON.parse(await environment.readFile(resolve(templateDir, 'package.json'), 'utf8'));
-    packageJSON.name = projectName;
-    if (options.typescript) {
-        const tsPackageJSON = JSON.parse(await environment.readFile(resolve(templateDir, 'package.ts.json'), 'utf8'));
-        packageJSON = {
-            ...packageJSON,
-            devDependencies: {
-                ...packageJSON.devDependencies,
-                ...tsPackageJSON.devDependencies,
-            },
-        };
-    }
-    if (options.tailwind) {
-        const twPackageJSON = JSON.parse(await environment.readFile(resolve(templateDir, 'package.tw.json'), 'utf8'));
-        packageJSON = {
-            ...packageJSON,
-            dependencies: {
-                ...packageJSON.dependencies,
-                ...twPackageJSON.dependencies,
-            },
-        };
-    }
-    if (options.toolchain === 'biome') {
-        const biomePackageJSON = JSON.parse(await environment.readFile(resolve(templateDir, 'package.biome.json'), 'utf8'));
-        packageJSON = {
-            ...packageJSON,
-            scripts: {
-                ...packageJSON.scripts,
-                ...biomePackageJSON.scripts,
-            },
-            devDependencies: {
-                ...packageJSON.devDependencies,
-                ...biomePackageJSON.devDependencies,
-            },
-        };
-    }
-    if (options.toolchain === 'eslint+prettier') {
-        const eslintPrettierPackageJSON = JSON.parse(await environment.readFile(resolve(templateDir, 'package.eslintprettier.json'), 'utf-8'));
-        packageJSON = {
-            ...packageJSON,
-            scripts: {
-                ...packageJSON.scripts,
-                ...eslintPrettierPackageJSON.scripts,
-            },
-            devDependencies: {
-                ...packageJSON.devDependencies,
-                ...eslintPrettierPackageJSON.devDependencies,
-            },
-        };
-    }
-    if (options.mode === FILE_ROUTER) {
-        const frPackageJSON = JSON.parse(await environment.readFile(resolve(routerDir, 'package.fr.json'), 'utf8'));
-        packageJSON = {
-            ...packageJSON,
-            dependencies: {
-                ...packageJSON.dependencies,
-                ...frPackageJSON.dependencies,
-            },
-        };
-    }
-    for (const addOn of addOns) {
-        packageJSON = {
-            ...packageJSON,
-            dependencies: {
-                ...packageJSON.dependencies,
-                ...addOn.dependencies,
-            },
-            devDependencies: {
-                ...packageJSON.devDependencies,
-                ...addOn.devDependencies,
-            },
-            scripts: {
-                ...packageJSON.scripts,
-                ...addOn.scripts,
-            },
-        };
-    }
-    packageJSON.dependencies = sortObject(packageJSON.dependencies);
-    packageJSON.devDependencies = sortObject(packageJSON.devDependencies);
-    await environment.writeFile(resolve(targetDir, 'package.json'), JSON.stringify(packageJSON, null, 2));
-}
-async function copyAddOnFile(environment, content, target, targetPath, templateFile) {
-    let targetFile = basename(target).replace(/^_dot_/, '.');
-    let isTemplate = false;
-    if (targetFile.endsWith('.ejs')) {
-        targetFile = targetFile.replace('.ejs', '');
-        isTemplate = true;
-    }
-    let isAppend = false;
-    if (targetFile.endsWith('.append')) {
-        targetFile = targetFile.replace('.append', '');
-        isAppend = true;
-    }
-    const finalTargetPath = resolve(dirname(targetPath), targetFile);
-    const binaryContent = getBinaryFile(content);
-    if (binaryContent) {
-        await environment.writeFile(finalTargetPath, binaryContent);
-        return;
-    }
-    if (isTemplate) {
-        await templateFile(content, finalTargetPath);
-    }
-    else {
-        if (isAppend) {
-            await environment.appendFile(finalTargetPath, content);
-        }
-        else {
-            await environment.writeFile(finalTargetPath, content);
-        }
-    }
-}
-export async function createApp(options, { silent = false, environment, cwd, appName = 'TanStack', }) {
-    environment.startRun();
-    const templateDirBase = resolve(getTemplatesRoot(), options.framework, 'base');
-    const templateDirRouter = resolve(getTemplatesRoot(), options.framework, options.mode);
-    let targetDir = cwd || '';
-    if (!targetDir.length) {
-        targetDir = resolve(process.cwd(), options.projectName);
-    }
-    const copyFiles = createCopyFiles(environment, targetDir);
-    const templateFileFromContent = createTemplateFile(environment, options.projectName, options, targetDir);
-    async function templateFile(templateBase, file, targetFileName, extraTemplateValues) {
-        const content = await environment.readFile(resolve(templateBase, file), 'utf-8');
-        return templateFileFromContent(file, content.toString(), targetFileName, extraTemplateValues);
-    }
-    const isAddOnEnabled = (id) => options.chosenAddOns.find((a) => a.id === id);
-    async function runAddOn(addOn) {
-        if (addOn.files) {
-            for (const file of Object.keys(addOn.files)) {
-                await copyAddOnFile(environment, addOn.files[file], file, resolve(targetDir, file), (content, targetFileName) => templateFileFromContent(targetFileName, content));
+            else {
+                await templateFileFromContent(file, contents);
             }
         }
-        if (addOn.deletedFiles) {
-            for (const file of addOn.deletedFiles) {
-                await environment.deleteFile(resolve(targetDir, file));
-            }
-        }
-        if (addOn.command && addOn.command.command) {
-            await environment.execute(addOn.command.command, addOn.command.args || [], resolve(targetDir));
-        }
-    }
-    // Setup the .vscode directory
-    switch (options.toolchain) {
-        case 'biome':
-            await environment.copyFile(resolve(templateDirBase, '_dot_vscode/settings.biome.json'), resolve(targetDir, '.vscode/settings.json'));
-            break;
-        case 'none':
-        default:
-            await environment.copyFile(resolve(templateDirBase, '_dot_vscode/settings.json'), resolve(targetDir, '.vscode/settings.json'));
-    }
-    // Fill the public directory
-    copyFiles(templateDirBase, [
-        './public/robots.txt',
-        './public/favicon.ico',
-        './public/manifest.json',
-        './public/logo192.png',
-        './public/logo512.png',
-    ]);
-    // Check for a .cursorrules file
-    if (environment.exists(resolve(templateDirBase, '.cursorrules'))) {
-        await environment.copyFile(resolve(templateDirBase, '.cursorrules'), resolve(targetDir, '.cursorrules'));
-    }
-    // Copy in Vite and Tailwind config and CSS
-    if (!options.tailwind) {
-        await copyFiles(templateDirBase, ['./src/App.css']);
-    }
-    // Don't create a vite.config.js file if we are building a Start app
-    if (!isAddOnEnabled('start')) {
-        await templateFile(templateDirBase, './vite.config.js.ejs');
-    }
-    await templateFile(templateDirBase, './src/styles.css.ejs');
-    copyFiles(templateDirBase, ['./src/logo.svg']);
-    if (options.toolchain === 'biome') {
-        copyFiles(templateDirBase, ['./toolchain/biome.json'], true);
-    }
-    if (options.toolchain === 'eslint+prettier') {
-        copyFiles(templateDirBase, [
-            './toolchain/eslint.config.js',
-            './toolchain/prettier.config.js',
-            './toolchain/.prettierignore',
-        ], true);
-    }
-    // Setup reportWebVitals
-    if (!isAddOnEnabled('start') && options.framework === 'react') {
-        if (options.typescript) {
-            await templateFile(templateDirBase, './src/reportWebVitals.ts.ejs');
-        }
-        else {
-            await templateFile(templateDirBase, './src/reportWebVitals.ts.ejs', './src/reportWebVitals.js');
+        const deletedFiles = await bundle.getDeletedFiles();
+        for (const file of deletedFiles) {
+            await environment.deleteFile(resolve(options.targetDir, file));
         }
     }
-    if (!isAddOnEnabled('start')) {
-        await templateFile(templateDirBase, './index.html.ejs');
-    }
-    // Add .gitignore
-    await environment.copyFile(resolve(templateDirBase, '_dot_gitignore'), resolve(targetDir, '.gitignore'));
-    // Setup tsconfig
-    if (options.typescript) {
-        await templateFile(templateDirBase, './tsconfig.json.ejs', './tsconfig.json');
-    }
-    // Setup the package.json file, optionally with typescript, tailwind and formatter/linter
-    await createPackageJSON(environment, options.projectName, options, templateDirBase, templateDirRouter, targetDir, options.chosenAddOns.map((addOn) => addOn.packageAdditions));
-    // Copy all the asset files from the addons
-    const s = silent ? null : spinner();
-    for (const type of ['add-on', 'example']) {
+    environment.startStep({
+        id: 'write-framework-files',
+        type: 'file',
+        message: 'Writing framework files...',
+    });
+    await writeFileBundle(options.framework);
+    environment.finishStep('write-framework-files', 'Framework files written');
+    let wroteAddonFiles = false;
+    for (const type of ['add-on', 'example', 'toolchain']) {
         for (const phase of ['setup', 'add-on', 'example']) {
             for (const addOn of options.chosenAddOns.filter((addOn) => addOn.phase === phase && addOn.type === type)) {
-                s?.start(`Setting up ${addOn.name}...`);
-                await runAddOn(addOn);
-                s?.stop(`${addOn.name} setup complete`);
+                environment.startStep({
+                    id: 'write-addon-files',
+                    type: 'file',
+                    message: `Writing ${addOn.name} files...`,
+                });
+                await writeFileBundle(addOn);
+                wroteAddonFiles = true;
             }
         }
     }
-    if (isAddOnEnabled('shadcn')) {
-        const shadcnComponents = new Set();
-        for (const addOn of options.chosenAddOns) {
-            if (addOn.shadcnComponents) {
-                for (const component of addOn.shadcnComponents) {
-                    shadcnComponents.add(component);
-                }
-            }
-        }
-        if (options.overlay) {
-            if (options.overlay.shadcnComponents) {
-                for (const component of options.overlay.shadcnComponents) {
-                    shadcnComponents.add(component);
-                }
-            }
-        }
-        if (shadcnComponents.size > 0) {
-            s?.start(`Installing shadcn components (${Array.from(shadcnComponents).join(', ')})...`);
-            await packageManagerExecute(environment, options.packageManager, 'shadcn@latest', ['add', '--silent', '--yes', ...shadcnComponents], resolve(targetDir));
-            s?.stop(`Installed additional shadcn components`);
-        }
+    if (wroteAddonFiles) {
+        environment.finishStep('write-addon-files', 'Add-on files written');
     }
-    const integrations = [];
-    if (environment.exists(resolve(targetDir, 'src/integrations'))) {
-        for (const integration of environment.readdir(resolve(targetDir, 'src/integrations'))) {
-            const integrationName = jsSafeName(integration);
-            if (environment.exists(resolve(targetDir, 'src/integrations', integration, 'layout.tsx'))) {
-                integrations.push({
-                    type: 'layout',
-                    name: `${integrationName}Layout`,
-                    path: `integrations/${integration}/layout`,
-                });
-            }
-            if (environment.exists(resolve(targetDir, 'src/integrations', integration, 'provider.tsx'))) {
-                integrations.push({
-                    type: 'provider',
-                    name: `${integrationName}Provider`,
-                    path: `integrations/${integration}/provider`,
-                });
-            }
-            if (environment.exists(resolve(targetDir, 'src/integrations', integration, 'root-provider.tsx'))) {
-                integrations.push({
-                    type: 'root-provider',
-                    name: integrationName,
-                    path: `integrations/${integration}/root-provider`,
-                });
-            }
-            if (environment.exists(resolve(targetDir, 'src/integrations', integration, 'header-user.tsx'))) {
-                integrations.push({
-                    type: 'header-user',
-                    name: `${integrationName}Header`,
-                    path: `integrations/${integration}/header-user`,
-                });
-            }
-        }
+    if (options.starter) {
+        environment.startStep({
+            id: 'write-starter-files',
+            type: 'file',
+            message: 'Writing starter files...',
+        });
+        await writeFileBundle(options.starter);
+        environment.finishStep('write-starter-files', 'Starter files written');
+    }
+    environment.startStep({
+        id: 'write-package-json',
+        type: 'file',
+        message: 'Writing package.json...',
+    });
+    await environment.writeFile(resolve(options.targetDir, './package.json'), JSON.stringify(createPackageJSON(options), null, 2));
+    environment.finishStep('write-package-json', 'Package.json written');
+    environment.startStep({
+        id: 'write-config-file',
+        type: 'file',
+        message: 'Writing config file...',
+    });
+    await writeConfigFileToEnvironment(environment, options);
+    environment.finishStep('write-config-file', 'Config file written');
+}
+async function runCommandsAndInstallDependencies(environment, options) {
+    const s = environment.spinner();
+    // Setup git
+    if (options.git) {
+        s.start(`Initializing git repository...`);
+        environment.startStep({
+            id: 'initialize-git-repository',
+            type: 'command',
+            message: 'Initializing git repository...',
+        });
+        await setupGit(environment, options.targetDir);
+        environment.finishStep('initialize-git-repository', 'Initialized git repository');
+        s.stop(`Initialized git repository`);
     }
-    const routes = [];
-    if (environment.exists(resolve(targetDir, 'src/routes'))) {
-        for (const file of environment.readdir(resolve(targetDir, 'src/routes'))) {
-            const name = file.replace(/\.tsx?|\.jsx?/, '');
-            const safeRouteName = jsSafeName(name);
-            routes.push({
-                path: `./routes/${name}`,
-                name: safeRouteName,
-            });
+    // Run any special steps for the new add-ons
+    const specialSteps = new Set([]);
+    for (const addOn of options.chosenAddOns) {
+        for (const step of addOn.createSpecialSteps || []) {
+            specialSteps.add(step);
         }
     }
-    // Create the main entry point
-    if (!isAddOnEnabled('start')) {
-        if (options.typescript) {
-            await templateFile(templateDirRouter, './src/main.tsx.ejs', './src/main.tsx', {
-                routes,
-                integrations,
+    if (specialSteps.size) {
+        await runSpecialSteps(environment, options, Array.from(specialSteps));
+    }
+    // Install dependencies
+    s.start(`Installing dependencies via ${options.packageManager}...`);
+    environment.startStep({
+        id: 'install-dependencies',
+        type: 'package-manager',
+        message: `Installing dependencies via ${options.packageManager}...`,
+    });
+    await packageManagerInstall(environment, options.targetDir, options.packageManager);
+    environment.finishStep('install-dependencies', 'Installed dependencies');
+    s.stop(`Installed dependencies`);
+    for (const phase of ['setup', 'add-on', 'example']) {
+        for (const addOn of options.chosenAddOns.filter((addOn) => addOn.phase === phase && addOn.command && addOn.command.command)) {
+            s.start(`Running commands for ${addOn.name}...`);
+            const cmd = formatCommand({
+                command: addOn.command.command,
+                args: addOn.command.args || [],
             });
-        }
-        else {
-            await templateFile(templateDirRouter, './src/main.tsx.ejs', './src/main.jsx', {
-                routes,
-                integrations,
+            environment.startStep({
+                id: 'run-commands',
+                type: 'command',
+                message: cmd,
             });
-        }
-    }
-    // Setup the app component. There are four variations, typescript/javascript and tailwind/non-tailwind.
-    if (options.mode === FILE_ROUTER) {
-        await templateFile(templateDirRouter, './src/routes/__root.tsx.ejs', './src/routes/__root.tsx', {
-            integrations,
+            await environment.execute(addOn.command.command, addOn.command.args || [], options.targetDir);
+            environment.finishStep('run-commands', 'Setup commands complete');
+            s.stop(`${addOn.name} commands complete`);
+        }
+    }
+    // Adding starter
+    if (options.starter &&
+        options.starter.command &&
+        options.starter.command.command) {
+        s.start(`Setting up starter ${options.starter.name}...`);
+        const cmd = formatCommand({
+            command: options.starter.command.command,
+            args: options.starter.command.args || [],
         });
-        await templateFile(templateDirBase, './src/App.tsx.ejs', './src/routes/index.tsx');
-    }
-    else {
-        await templateFile(templateDirBase, './src/App.tsx.ejs', options.typescript ? undefined : './src/App.jsx');
-        if (options.framework === 'react') {
-            await templateFile(templateDirBase, './src/App.test.tsx.ejs', options.typescript ? undefined : './src/App.test.jsx');
-        }
-    }
-    if (routes.length > 0 ||
-        options.chosenAddOns.length > 0 ||
-        integrations.length > 0) {
-        await templateFile(templateDirBase, './src/components/Header.tsx.ejs', './src/components/Header.tsx', {
-            integrations,
+        environment.startStep({
+            id: 'run-starter-command',
+            type: 'command',
+            message: cmd,
         });
+        await environment.execute(options.starter.command.command, options.starter.command.args || [], options.targetDir);
+        environment.finishStep('run-starter-command', 'Starter command complete');
+        s.stop(`${options.starter.name} commands complete`);
     }
+    await installShadcnComponents(environment, options.targetDir, options);
+}
+function report(environment, options) {
     const warnings = [];
     for (const addOn of options.chosenAddOns) {
         if (addOn.warning) {
             warnings.push(addOn.warning);
         }
     }
-    // Create the README.md
-    await templateFile(templateDirBase, 'README.md.ejs');
-    // Adding overlay
-    if (options.overlay) {
-        s?.start(`Setting up overlay ${options.overlay.name}...`);
-        await runAddOn(options.overlay);
-        s?.stop(`Overlay ${options.overlay.name} setup complete`);
-    }
-    // Install dependencies
-    s?.start(`Installing dependencies via ${options.packageManager}...`);
-    await environment.execute(options.packageManager, ['install'], resolve(targetDir));
-    s?.stop(`Installed dependencies`);
     if (warnings.length > 0) {
-        if (!silent) {
-            log.warn(chalk.red(warnings.join('\n')));
-        }
+        environment.warn('Warnings', warnings.join('\n'));
     }
-    if (options.toolchain === 'biome') {
-        s?.start(`Applying toolchain ${options.toolchain}...`);
-        switch (options.packageManager) {
-            case 'pnpm':
-                // pnpm automatically forwards extra arguments
-                await environment.execute(options.packageManager, ['run', 'check', '--fix'], resolve(targetDir));
-                break;
-            default:
-                await environment.execute(options.packageManager, ['run', 'check', '--', '--fix'], resolve(targetDir));
-                break;
-        }
-        s?.stop(`Applied toolchain ${options.toolchain}...`);
-    }
-    if (options.toolchain === 'eslint+prettier') {
-        s?.start(`Applying toolchain ${options.toolchain}...`);
-        await environment.execute(options.packageManager, ['run', 'check'], targetDir);
-        s?.stop(`Applied toolchain ${options.toolchain}...`);
-    }
-    if (options.git) {
-        s?.start(`Initializing git repository...`);
-        await environment.execute('git', ['init'], resolve(targetDir));
-        s?.stop(`Initialized git repository`);
-    }
-    await writeConfigFile(environment, targetDir, options);
-    environment.finishRun();
+    // Format errors
     let errorStatement = '';
     if (environment.getErrors().length) {
         errorStatement = `
 
-${chalk.red('Errors were encountered during this process:')}
+Errors were encountered during the creation of your app:
 
 ${environment.getErrors().join('\n')}`;
     }
-    if (!silent) {
-        let startCommand = `${options.packageManager} ${isAddOnEnabled('start') ? 'dev' : 'start'}`;
-        if (options.packageManager === 'deno') {
-            startCommand = `deno ${isAddOnEnabled('start') ? 'task dev' : 'start'}`;
-        }
-        outro(`Your ${appName} app is ready in '${basename(targetDir)}'.
+    environment.outro(`Your ${environment.appName} app is ready in '${basename(options.targetDir)}'.
 
 Use the following commands to start your app:
 % cd ${options.projectName}
-% ${startCommand}
+% ${formatCommand(getPackageManagerScriptCommand(options.packageManager, ['dev']))}
 
-Please check the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`);
-    }
+Please check the README.md for more information on testing, styling, adding routes, etc.${errorStatement}`);
+}
+export async function createApp(environment, options) {
+    environment.startRun();
+    await writeFiles(environment, options);
+    await runCommandsAndInstallDependencies(environment, options);
+    environment.finishRun();
+    report(environment, options);
 }