dappbooster 3.2.0 → 3.3.1

package/dist/app.js

@@ -35,7 +35,7 @@ const App = ({ preselectedStack }) => {
         setCurrentStep(1);
         setAttempt((prev) => prev + 1);
     }, [preselectedStack]);
-    const skipFeatures = setupType?.value === 'full';
+    const skipFeatures = setupType?.value === 'full' || setupType?.value === 'default';
     const mode = setupType?.value ?? 'full';
     const planFeatures = selectedFeatures?.map((item) => item.value) ?? [];
     const planSummary = stack === undefined ? '' : describeInstallPlan(stack, projectName, mode, planFeatures);
@@ -52,7 +52,7 @@ const App = ({ preselectedStack }) => {
             return orderedSteps;
         }
         // --- remaining questions (need the stack) ---
-        orderedSteps.push(_jsx(InstallationMode, { onCompletion: finishStep, onSelect: onSelectSetupType }, `installation-mode-${attempt}`));
+        orderedSteps.push(_jsx(InstallationMode, { stack: stack, onCompletion: finishStep, onSelect: onSelectSetupType }, `installation-mode-${attempt}`));
         orderedSteps.push(_jsx(OptionalPackages, { stack: stack, onCompletion: finishStep, onSubmit: onSelectSelectedFeatures, skip: skipFeatures }, `optional-packages-${attempt}`));
         orderedSteps.push(_jsx(Confirmation, { summary: planSummary, onConfirm: finishStep, onCancel: restart }, `confirmation-${attempt}`));
         // --- operations (disk writes) ---

package/dist/cli.js

@@ -16,7 +16,7 @@ const cli = meow(`
 
   Common options
     --name <string>          Project name (alphanumeric, underscores)
-    --mode <full|custom>     Installation mode
+    --mode <full|default|custom>  Installation mode (default mode is Canton-only)
     --features <list>        Comma-separated features (with --mode=custom)
                                EVM:
                                  demo       Component demos and example pages
@@ -25,12 +25,13 @@ const cli = meow(`
                                  vocs       Vocs documentation site
                                  husky      Git hooks (Husky, lint-staged, commitlint)
                                Canton:
-                                 counter    Counter demo dapp
-                                 e2e        Playwright end-to-end tests (requires counter)
+                                 github     GitHub issue/PR templates and workflows
+                                 precommit  Pre-commit hooks (Husky, lint-staged, commitlint)
                                  carpincho  Carpincho browser-extension wallet
                                  llm        LLM and agent artifacts (.claude, AGENTS.md, …)
-                               Dependencies are auto-resolved: requesting e2e
-                               also pulls in counter.
+                               Canton's default mode keeps carpincho + llm and removes
+                               github + precommit; full keeps everything; custom lets you
+                               pick (github + precommit start unchecked).
     --non-interactive, --ni  Run without prompts (auto-enabled when not a TTY)
     --info                   Output feature metadata as JSON (filter with --stack)
     --help                   Show this help
@@ -52,8 +53,8 @@ const cli = meow(`
     Interactive (prompts for stack and options):
       $ dappbooster
 
-    Canton stack, full install (non-interactive):
-      $ dappbooster --canton --ni --name my_dapp --mode full
+    Canton stack, recommended install (non-interactive):
+      $ dappbooster --canton --ni --name my_dapp --mode default
 
     EVM stack, custom install:
       $ dappbooster --evm --ni --name my_dapp --mode custom --features demo,subgraph

package/dist/components/steps/FileCleanup.js

@@ -3,7 +3,7 @@ import { Text } from 'ink';
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { cleanupFiles } from '../../operations/index.js';
 import { completeInstall } from '../../operations/installGuard.js';
-import { deriveStepDisplay, getProjectFolder } from '../../utils/utils.js';
+import { deriveStepDisplay, getProjectFolder, resolveModeFeatures } from '../../utils/utils.js';
 import Divider from '../Divider.js';
 const FileCleanup = ({ stack, onCompletion, installationConfig, projectName }) => {
     const { installationType, selectedFeatures } = installationConfig;
@@ -15,8 +15,10 @@ const FileCleanup = ({ stack, onCompletion, installationConfig, projectName }) =
         setSteps((prev) => [...prev, step]);
     }, []);
     useEffect(() => {
-        const features = selectedFeatures?.map((f) => f.value) ?? [];
-        cleanupFiles(stack, projectFolder, installationType ?? 'full', features, handleProgress)
+        const mode = installationType ?? 'full';
+        const selectedNames = selectedFeatures?.map((f) => f.value) ?? [];
+        const features = resolveModeFeatures(stack, mode, selectedNames);
+        cleanupFiles(stack, projectFolder, mode, features, handleProgress)
             .then(() => {
             // Scaffold is complete — an interrupt from here on must not delete the finished project.
             completeInstall();

package/dist/components/steps/Install/Install.js

@@ -3,7 +3,7 @@ import { Text } from 'ink';
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { createEnvFile } from '../../../operations/createEnvFile.js';
 import { installPackages } from '../../../operations/installPackages.js';
-import { deriveStepDisplay, getProjectFolder } from '../../../utils/utils.js';
+import { deriveStepDisplay, getProjectFolder, resolveModeFeatures } from '../../../utils/utils.js';
 import Divider from '../../Divider.js';
 const Install = ({ stack, projectName, onCompletion, installationConfig }) => {
     const { installationType, selectedFeatures } = installationConfig;
@@ -18,11 +18,13 @@ const Install = ({ stack, projectName, onCompletion, installationConfig }) => {
         setSteps((prev) => [...prev, step]);
     }, []);
     useEffect(() => {
-        const features = selectedFeatures?.map((f) => f.value) ?? [];
+        const mode = installationType ?? 'full';
+        const selectedNames = selectedFeatures?.map((f) => f.value) ?? [];
+        const features = resolveModeFeatures(stack, mode, selectedNames);
         const run = async () => {
             handleProgress('Creating env files');
             await createEnvFile(stack, projectFolder, features);
-            await installPackages(stack, projectFolder, installationType ?? 'full', features, handleProgress);
+            await installPackages(stack, projectFolder, mode, features, handleProgress);
         };
         run()
             .then(() => {

package/dist/components/steps/InstallationMode.d.ts

@@ -1,6 +1,8 @@
 import { type FC } from 'react';
+import { type Stack } from '../../constants/config.js';
 import type { InstallationSelectItem } from '../../types/types.js';
 interface Props {
+    stack: Stack;
     onCompletion: () => void;
     onSelect: (item: InstallationSelectItem) => void;
 }

package/dist/components/steps/InstallationMode.js

@@ -3,19 +3,16 @@ import figures from 'figures';
 import { Text } from 'ink';
 import SelectInput from 'ink-select-input';
 import { useState } from 'react';
+import { getInstallationModes } from '../../constants/config.js';
 import Divider from '../Divider.js';
-const installationTypeItems = [
-    {
-        label: 'Full',
-        value: 'full',
-    },
-    {
-        label: 'Custom',
-        value: 'custom',
-    },
-];
-const InstallationMode = ({ onCompletion, onSelect }) => {
+const MODE_LABELS = {
+    default: 'Default (recommended)',
+    full: 'Full',
+    custom: 'Custom',
+};
+const InstallationMode = ({ stack, onCompletion, onSelect }) => {
     const [selected, setSelected] = useState();
+    const installationTypeItems = getInstallationModes(stack).map((value) => ({ label: MODE_LABELS[value], value }));
     const handleSelect = (item) => {
         onSelect(item);
         setSelected(item);

package/dist/components/steps/OptionalPackages.js

@@ -13,7 +13,12 @@ const OptionalPackages = ({ stack, onCompletion, onSubmit, skip = false }) => {
             value: name,
         }));
     }, [stack]);
-    // Keep the selection dependency-consistent as the user toggles (e.g. e2e requires counter).
+    // Pre-check only default:true features (e.g. Canton's github/precommit start unchecked).
+    const defaultSelected = useMemo(() => {
+        const features = getStackConfig(stack).features;
+        return customPackages.filter((pkg) => features[pkg.value]?.default);
+    }, [stack, customPackages]);
+    // Keep the selection dependency-consistent as the user toggles (resolves any feature `requires`).
     const transformSelection = useCallback((nextSelected, toggledItem, action) => {
         const selectedValues = nextSelected.map((item) => item.value);
         const resolved = applyFeatureToggle(stack, selectedValues, toggledItem.value, action);
@@ -38,6 +43,6 @@ const OptionalPackages = ({ stack, onCompletion, onSubmit, skip = false }) => {
     if (submitted) {
         return (_jsxs(Text, { children: ["Optional packages:", ' ', _jsx(Text, { bold: true, color: 'green', children: submitted.length > 0 ? submitted.map((item) => item.label).join(', ') : 'none' })] }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(Text, { color: 'whiteBright', children: "Choose optional packages" }), _jsx(MultiSelect, { defaultSelected: customPackages, focus: true, items: customPackages, onSubmit: onHandleSubmit, transformSelection: transformSelection })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { color: 'whiteBright', children: "Choose optional packages" }), _jsx(MultiSelect, { defaultSelected: defaultSelected, focus: true, items: customPackages, onSubmit: onHandleSubmit, transformSelection: transformSelection })] }));
 };
 export default OptionalPackages;

package/dist/components/steps/PostInstall.js

@@ -3,21 +3,20 @@ import figures from 'figures';
 import { Box, Text } from 'ink';
 import Link from 'ink-link';
 import { getStackConfig } from '../../constants/config.js';
-import { isFeatureSelected } from '../../utils/utils.js';
+import { isFeatureSelected, resolveModeFeatures } from '../../utils/utils.js';
 import Divider from '../Divider.js';
 const SubgraphWarningMessage = () => (_jsxs(Box, { flexDirection: 'column', rowGap: 1, children: [_jsx(Box, { alignItems: 'center', borderColor: 'yellow', borderStyle: 'bold', flexDirection: 'column', justifyContent: 'center', padding: 1, children: _jsxs(Text, { color: 'yellow', children: [figures.warning, figures.warning, " ", _jsx(Text, { bold: true, children: "WARNING:" }), " You ", _jsx(Text, { bold: true, children: "MUST" }), " finish the subgraph's configuration manually ", figures.warning, figures.warning] }) }), _jsx(Text, { color: 'whiteBright', children: "Follow these steps:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Provide your own API key for ", _jsx(Text, { color: 'gray', children: "PUBLIC_SUBGRAPHS_API_KEY" }), " in", ' ', _jsx(Text, { color: 'gray', children: ".env.local" }), " You can get one", ' ', _jsx(Link, { url: "https://thegraph.com/studio/apikeys", children: "here" })] }), _jsxs(Text, { children: ["2- After the API key is correctly configured, run", ' ', _jsx(Text, { color: 'gray', children: "pnpm subgraph-codegen" }), " in your console from the project's folder"] })] }), _jsxs(Text, { children: ["More configuration info in", ' ', _jsx(Link, { url: 'https://docs.dappbooster.dev/introduction/getting-started', children: "the docs" }), "."] }), _jsxs(Text, { color: 'yellow', bold: true, children: [figures.info, " Only after you have followed the previous steps you may proceed."] })] }));
 const EvmPostInstallMessage = ({ projectName }) => (_jsxs(Box, { flexDirection: 'column', rowGap: 1, paddingBottom: 2, children: [_jsx(Text, { color: 'whiteBright', children: "To start development on your project:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Move into the project's folder with ", _jsxs(Text, { color: 'gray', children: ["cd ", projectName] })] }), _jsxs(Text, { children: ["2- Start the development server with ", _jsx(Text, { color: 'gray', children: "pnpm dev" })] })] }), _jsx(Text, { color: 'whiteBright', children: "More info:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["- Check out ", _jsx(Text, { color: 'gray', children: ".env.local" }), " for more configurations."] }), _jsxs(Text, { children: ["- Read ", _jsx(Link, { url: "https://docs.dappbooster.dev", children: "the docs" }), " to know more about", ' ', _jsx(Text, { color: 'gray', children: "dAppBooster" }), "!"] }), _jsxs(Text, { children: ["- Report issues with this installer", ' ', _jsx(Link, { url: "https://github.com/BootNodeDev/dAppBoosterInstallScript/issues", children: "here" })] })] })] }));
-const CantonPostInstallMessage = ({ projectName, features, installationType }) => {
-    const isFull = installationType === 'full';
-    const counterEnabled = isFull || isFeatureSelected('counter', features);
-    const carpinchoEnabled = isFull || isFeatureSelected('carpincho', features);
-    return (_jsxs(Box, { flexDirection: 'column', rowGap: 1, paddingBottom: 2, children: [_jsx(Text, { color: 'whiteBright', children: "To start the Canton stack:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Move into the project's folder with ", _jsxs(Text, { color: 'gray', children: ["cd ", projectName] })] }), _jsxs(Text, { children: ["2- Configure canton-barebones: ", _jsx(Text, { color: 'gray', children: "canton-barebones/.env" }), " was created from the example \u2014 review it."] }), _jsxs(Text, { children: ["3- Start the local Canton stack with ", _jsx(Text, { color: 'gray', children: "npm run canton:up" })] }), counterEnabled && (_jsxs(Text, { children: ["4- In a separate terminal, run the counter dapp:", ' ', _jsx(Text, { color: 'gray', children: "npm run app:dev" })] }))] }), carpinchoEnabled && (_jsx(Box, { alignItems: 'center', borderColor: 'yellow', borderStyle: 'bold', flexDirection: 'column', justifyContent: 'center', padding: 1, children: _jsxs(Text, { color: 'yellow', children: [figures.info, " ", _jsx(Text, { bold: true, children: "Carpincho Wallet" }), ": build it with", ' ', _jsx(Text, { color: 'gray', children: "npm run carpincho:build:extension" }), " and load", ' ', _jsx(Text, { color: 'gray', children: "carpincho-wallet/dist-extension" }), " as an unpacked browser extension ", figures.info] }) })), _jsx(Text, { children: "See the Canton stack README inside the project for full instructions." })] }));
+const CantonPostInstallMessage = ({ projectName, features }) => {
+    const carpinchoEnabled = isFeatureSelected('carpincho', features);
+    return (_jsxs(Box, { flexDirection: 'column', rowGap: 1, paddingBottom: 2, children: [_jsx(Text, { color: 'whiteBright', children: "To start the Canton stack:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Move into the project's folder with ", _jsxs(Text, { color: 'gray', children: ["cd ", projectName] })] }), _jsxs(Text, { children: ["2- Configure canton-barebones: ", _jsx(Text, { color: 'gray', children: "canton-barebones/.env" }), " was created from the example \u2014 review it."] }), _jsxs(Text, { children: ["3- Bring up the whole local stack with one command:", ' ', _jsx(Text, { color: 'gray', children: "./scripts/dev-stack.sh up" }), " (Docker must be running). Run", ' ', _jsx(Text, { color: 'gray', children: "./scripts/dev-stack.sh" }), " with no arguments for an interactive menu."] })] }), carpinchoEnabled && (_jsx(Box, { alignItems: 'center', borderColor: 'yellow', borderStyle: 'bold', flexDirection: 'column', justifyContent: 'center', padding: 1, children: _jsxs(Text, { color: 'yellow', children: [figures.info, " ", _jsx(Text, { bold: true, children: "Carpincho Wallet" }), ":", ' ', _jsx(Text, { color: 'gray', children: "./scripts/dev-stack.sh up" }), " also builds the extension and copies it to ", _jsx(Text, { color: 'gray', children: "~/Desktop/dist-extension" }), " \u2014 load it via", ' ', _jsx(Text, { color: 'gray', children: "chrome://extensions" }), " (Developer mode, Load unpacked)", ' ', figures.info] }) })), _jsxs(Box, { flexDirection: 'column', children: [_jsx(Text, { color: 'whiteBright', children: "Prefer to run the pieces by hand?" }), _jsxs(Text, { children: ["- Start the Canton stack with ", _jsx(Text, { color: 'gray', children: "npm run canton:up" }), ", then run the dapp frontend with ", _jsx(Text, { color: 'gray', children: "npm run app:dev" }), "."] }), carpinchoEnabled && (_jsxs(Text, { children: ["- Build the Carpincho extension with", ' ', _jsx(Text, { color: 'gray', children: "npm run carpincho:build:extension" }), " and load", ' ', _jsx(Text, { color: 'gray', children: "carpincho-wallet/dist-extension" }), " as an unpacked browser extension."] }))] }), _jsx(Text, { children: "See the Canton stack README inside the project for full instructions." })] }));
 };
 const PostInstall = ({ stack, installationConfig, projectName }) => {
     const { selectedFeatures, installationType } = installationConfig;
-    const features = selectedFeatures?.map((f) => f.value) ?? [];
+    const selectedNames = selectedFeatures?.map((f) => f.value) ?? [];
+    const features = resolveModeFeatures(stack, installationType ?? 'full', selectedNames);
     const stackLabel = getStackConfig(stack).label;
     return (_jsxs(_Fragment, { children: [_jsx(Divider, { title: `Post-install instructions — ${stackLabel}` }), _jsxs(Box, { flexDirection: 'column', rowGap: 2, children: [stack === 'evm' &&
-                        (isFeatureSelected('subgraph', features) || installationType === 'full') && (_jsx(SubgraphWarningMessage, {})), stack === 'evm' && _jsx(EvmPostInstallMessage, { projectName: projectName }), stack === 'canton' && (_jsx(CantonPostInstallMessage, { projectName: projectName, features: features, installationType: installationType }))] })] }));
+                        (isFeatureSelected('subgraph', features) || installationType === 'full') && (_jsx(SubgraphWarningMessage, {})), stack === 'evm' && _jsx(EvmPostInstallMessage, { projectName: projectName }), stack === 'canton' && (_jsx(CantonPostInstallMessage, { projectName: projectName, features: features }))] })] }));
 };
 export default PostInstall;

package/dist/constants/config.d.ts

@@ -1,3 +1,4 @@
+import type { InstallationType } from '../types/types.js';
 export type Stack = 'evm' | 'canton';
 export type RefType = 'tag-latest' | 'branch';
 export type PackageManager = 'pnpm' | 'npm';
@@ -24,6 +25,7 @@ export type StackConfig = {
     ref?: string;
     packageManager: PackageManager;
     removeAfterClone: string[];
+    postInstall?: string[];
     envFiles: EnvFile[];
     features: Record<FeatureName, FeatureDefinition>;
 };
@@ -33,3 +35,5 @@ export declare function getStackConfig(stack: Stack): StackConfig;
 export declare function getFeatureNames(stack: Stack): FeatureName[];
 export declare function isFeatureNameValid(stack: Stack, name: string): boolean;
 export declare function isStackName(name: string): name is Stack;
+export declare function getDefaultFeatureNames(stack: Stack): FeatureName[];
+export declare function getInstallationModes(stack: Stack): InstallationType[];

package/dist/constants/config.js

@@ -65,13 +65,14 @@ export const stackDefinitions = {
         ref: 'main',
         packageManager: 'npm',
         removeAfterClone: [],
+        postInstall: [
+            'Review canton-barebones/.env (created from the example)',
+            'Run ./scripts/dev-stack.sh up to bring up the whole local stack in one command — Docker must be running (run ./scripts/dev-stack.sh with no arguments for an interactive menu)',
+            'Fallback — start each piece manually: npm run canton:up for the Canton stack, then npm run app:dev for the dapp frontend',
+        ],
         envFiles: [
             { from: 'canton-barebones/.env.example', to: 'canton-barebones/.env' },
-            {
-                from: 'counter/frontend/.env.local.example',
-                to: 'counter/frontend/.env.local',
-                ifFeature: 'counter',
-            },
+            { from: 'dapp/frontend/.env.local.example', to: 'dapp/frontend/.env.local' },
             {
                 from: 'carpincho-wallet/.env.local.example',
                 to: 'carpincho-wallet/.env.local',
@@ -79,25 +80,19 @@ export const stackDefinitions = {
             },
         ],
         features: {
-            counter: {
-                description: 'Counter demo dapp (frontend + Daml + wallet-service)',
-                label: 'Counter demo',
+            github: {
+                description: 'GitHub issue/PR templates and workflows (.github)',
+                label: 'GitHub templates & workflows',
                 packages: [],
-                default: true,
-                paths: ['counter'],
-                postInstall: [
-                    'Review canton-barebones/.env (created from the example)',
-                    'Run npm run canton:up to start the local Canton stack',
-                    'Run npm run app:dev to start the counter dapp frontend',
-                ],
+                default: false,
+                paths: ['.github'],
             },
-            e2e: {
-                description: 'Playwright end-to-end test suite (drives the counter dapp)',
-                label: 'E2E tests',
+            precommit: {
+                description: 'Pre-commit hooks (Husky, lint-staged, commitlint)',
+                label: 'Pre-commit hooks',
                 packages: [],
-                default: true,
-                paths: ['e2e'],
-                requires: ['counter'],
+                default: false,
+                paths: ['.husky', '.lintstagedrc.mjs', 'commitlint.config.js'],
             },
             carpincho: {
                 description: 'Carpincho browser-extension wallet (frontend + build tooling)',
@@ -106,8 +101,8 @@ export const stackDefinitions = {
                 default: true,
                 paths: ['carpincho-wallet'],
                 postInstall: [
-                    'Build the Carpincho extension with npm run carpincho:build:extension',
-                    'Load carpincho-wallet/dist-extension as an unpacked browser extension',
+                    './scripts/dev-stack.sh up also builds the Carpincho extension and copies it to ~/Desktop/dist-extension (load it via chrome://extensions, Developer mode -> Load unpacked)',
+                    'Fallback — build it manually with npm run carpincho:build:extension, then load carpincho-wallet/dist-extension as an unpacked browser extension',
                 ],
             },
             llm: {
@@ -153,3 +148,15 @@ export function isFeatureNameValid(stack, name) {
 export function isStackName(name) {
     return stackNames.includes(name);
 }
+export function getDefaultFeatureNames(stack) {
+    return Object.entries(stackDefinitions[stack].features)
+        .filter(([, definition]) => definition.default)
+        .map(([name]) => name);
+}
+// Available installation modes per stack. `default` (keep only default:true features) is offered
+// only when the stack has at least one opt-out (default:false) feature; otherwise it would be
+// identical to `full`. Today that means Canton only (EVM's features are all default:true).
+export function getInstallationModes(stack) {
+    const hasOptOutFeature = getDefaultFeatureNames(stack).length < getFeatureNames(stack).length;
+    return hasOptOutFeature ? ['default', 'full', 'custom'] : ['full', 'custom'];
+}

package/dist/info.js

@@ -37,6 +37,7 @@ export function getInfoOutput(stackFilter) {
         stacks,
         modes: {
             full: 'Install all features',
+            default: 'Install the recommended set (Canton only; for EVM this equals full)',
             custom: 'Choose features individually',
         },
     }, null, 2);

package/dist/nonInteractive.js

@@ -2,7 +2,7 @@ import process from 'node:process';
 import { getFeatureNames, isFeatureNameValid, isStackName, stackNames, } from './constants/config.js';
 import { cleanupFiles, cloneRepo, createEnvFile, installPackages } from './operations/index.js';
 import { beginInstall, completeInstall } from './operations/installGuard.js';
-import { getPostInstallMessages, getProjectFolder, isValidName, projectDirectoryExists, resolveSelectedFeatures, } from './utils/utils.js';
+import { getPostInstallMessages, getProjectFolder, isValidName, projectDirectoryExists, resolveModeFeatures, } from './utils/utils.js';
 function fail(error) {
     const result = { success: false, error };
     console.log(JSON.stringify(result, null, 2));
@@ -40,14 +40,22 @@ function validate(flags) {
     if (!isValidName(flags.name)) {
         fail('Invalid project name: only letters, numbers, and underscores are allowed');
     }
-    if (flags.mode !== 'full' && flags.mode !== 'custom') {
-        fail("Invalid mode: must be 'full' or 'custom'");
+    if (flags.mode !== 'full' && flags.mode !== 'default' && flags.mode !== 'custom') {
+        fail("Invalid mode: must be 'full', 'default', or 'custom'");
     }
-    if (flags.mode === 'full') {
+    if (flags.mode === 'default' && stack === 'evm') {
+        fail("Invalid mode: 'default' is only available for the canton stack");
+    }
+    if (flags.mode === 'full' || flags.mode === 'default') {
         if (projectDirectoryExists(flags.name)) {
             fail(`Project directory '${flags.name}' already exists`);
         }
-        return { stack, name: flags.name, mode: flags.mode, features: getFeatureNames(stack) };
+        return {
+            stack,
+            name: flags.name,
+            mode: flags.mode,
+            features: resolveModeFeatures(stack, flags.mode),
+        };
     }
     if (!flags.features) {
         fail('--mode custom requires --features. Use --info to see available features.');
@@ -68,7 +76,7 @@ function validate(flags) {
         stack,
         name: flags.name,
         mode: flags.mode,
-        features: resolveSelectedFeatures(stack, features),
+        features: resolveModeFeatures(stack, 'custom', features),
     };
 }
 export async function runNonInteractive(flags) {

package/dist/operations/cleanupFiles.js

@@ -29,32 +29,37 @@ function removePackageKeys(packageBlock, keys) {
     }
     return changed;
 }
+// Strip the husky/lint-staged/commitlint tooling scripts and dependencies from a parsed
+// package.json (mutates in place). Returns whether anything was removed.
+function stripToolingEntries(packageJson, scripts) {
+    let changed = false;
+    if (scripts) {
+        for (const scriptName of TOOLING_SCRIPTS_TO_REMOVE) {
+            if (scripts[scriptName] !== undefined) {
+                scripts[scriptName] = undefined;
+                changed = true;
+            }
+        }
+    }
+    const dependencyGroups = [
+        packageJson.dependencies,
+        packageJson.devDependencies,
+        packageJson.optionalDependencies,
+        packageJson.peerDependencies,
+    ];
+    for (const group of dependencyGroups) {
+        if (removePackageKeys(group, TOOLING_PACKAGES_TO_REMOVE)) {
+            changed = true;
+        }
+    }
+    return changed;
+}
 function sanitizeRepositoryPackageJson(projectFolder) {
     const packageJsonPath = resolve(projectFolder, 'package.json');
     try {
         const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
         const scripts = packageJson.scripts;
-        let changed = false;
-        if (scripts) {
-            for (const scriptName of TOOLING_SCRIPTS_TO_REMOVE) {
-                if (scripts[scriptName] !== undefined) {
-                    scripts[scriptName] = undefined;
-                    changed = true;
-                }
-            }
-        }
-        const dependencyGroups = [
-            packageJson.dependencies,
-            packageJson.devDependencies,
-            packageJson.optionalDependencies,
-            packageJson.peerDependencies,
-        ];
-        for (const group of dependencyGroups) {
-            if (removePackageKeys(group, TOOLING_PACKAGES_TO_REMOVE)) {
-                changed = true;
-            }
-        }
-        if (changed) {
+        if (stripToolingEntries(packageJson, scripts)) {
             writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
         }
     }
@@ -67,10 +72,11 @@ async function removePaths(projectFolder, relativePaths) {
         await rm(resolve(projectFolder, relativePath), { recursive: true, force: true });
     }
 }
-async function cleanupRepositoryHygiene(stack, projectFolder, onProgress) {
+// EVM-only hygiene: always strip CI metadata, agent metadata, and git automation. Canton models
+// .github and pre-commit hooks as optional features instead (see cleanupCantonFiles).
+async function cleanupRepositoryHygiene(projectFolder, onProgress) {
     onProgress?.('Repository metadata');
-    const metadataPaths = stack === 'evm' ? [...EVM_METADATA_PATHS, ...CI_PATHS] : CI_PATHS;
-    await removePaths(projectFolder, metadataPaths);
+    await removePaths(projectFolder, [...EVM_METADATA_PATHS, ...CI_PATHS]);
     onProgress?.('Git hooks and commit linting');
     await removePaths(projectFolder, AUTOMATION_PATHS);
     sanitizeRepositoryPackageJson(projectFolder);
@@ -102,35 +108,36 @@ function patchPackageJsonEvm(projectFolder, features) {
     scripts['commitlint:ci'] = undefined;
     writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
 }
-// Strip scripts by what they run (e.g. `npm --prefix counter/frontend ...`)
+// Strip scripts by what they run (e.g. `npm --prefix carpincho-wallet ...`)
 // rather than by name, so cleanup tracks directory removal even as scripts change.
 function scriptTargetsRemovedDir(command, removedDirs) {
     const tokens = command.split(/\s+/);
     return removedDirs.some((dir) => tokens.some((token) => token === dir || token.startsWith(`${dir}/`)));
 }
-function patchPackageJsonCanton(projectFolder, removedDirs) {
+function patchPackageJsonCanton(projectFolder, removedDirs, precommitRemoved) {
     const packageJsonPath = resolve(projectFolder, 'package.json');
     const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
     const scripts = packageJson.scripts;
-    if (!scripts) {
-        writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
-        return;
-    }
-    for (const [name, command] of Object.entries(scripts)) {
-        if (command !== undefined && scriptTargetsRemovedDir(command, removedDirs)) {
-            scripts[name] = undefined;
+    if (scripts) {
+        for (const [name, command] of Object.entries(scripts)) {
+            if (command !== undefined && scriptTargetsRemovedDir(command, removedDirs)) {
+                scripts[name] = undefined;
+            }
         }
     }
-    // biome-ignore lint/complexity/useLiteralKeys: TS index-signature compatibility in strict mode
-    scripts['prepare'] = undefined;
-    // biome-ignore lint/complexity/useLiteralKeys: TS index-signature compatibility in strict mode
-    scripts['commitlint'] = undefined;
-    scripts['commitlint:check'] = undefined;
-    scripts['commitlint:ci'] = undefined;
+    // The husky tooling (prepare/commitlint scripts + husky/lint-staged/commitlint deps) only leaves
+    // with the pre-commit feature.
+    if (precommitRemoved) {
+        stripToolingEntries(packageJson, scripts);
+    }
     writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
 }
 async function createInitialCommit(projectFolder) {
     await execFile('git', ['add', '.'], { cwd: projectFolder });
+    // --no-verify: the scaffold's baseline commit must not run the project's own git hooks. When the
+    // `precommit` feature is kept, husky's pre-commit/commit-msg hooks are present and would lint and
+    // test the freshly-cloned tree (and fail), blocking the install. The user's later commits still
+    // run hooks normally.
     await execFile('git', [
         '-c',
         'user.name=dAppBooster',
@@ -139,6 +146,7 @@ async function createInitialCommit(projectFolder) {
         '-c',
         'commit.gpgsign=false',
         'commit',
+        '--no-verify',
         '-m',
         'chore: initial commit',
     ], { cwd: projectFolder });
@@ -190,10 +198,11 @@ async function cleanupEvmFiles(projectFolder, mode, features, onProgress) {
 }
 async function cleanupCantonFiles(projectFolder, mode, features, onProgress) {
     const cantonFeatures = getStackConfig('canton').features;
-    // Each deselected feature contributes its paths to removal (custom mode only). Directory paths
-    // also feed script stripping, so a removed feature's package.json scripts disappear with it.
+    // Each deselected feature contributes its paths to removal. `default` and `custom` remove;
+    // `full` keeps everything. Directory paths also feed script stripping, so a removed feature's
+    // package.json scripts disappear with it.
     const removedDirs = [];
-    if (mode === 'custom') {
+    if (mode !== 'full') {
         for (const [name, definition] of Object.entries(cantonFeatures)) {
             if (isFeatureSelected(name, features) || !definition.paths || definition.paths.length === 0) {
                 continue;
@@ -203,15 +212,16 @@ async function cleanupCantonFiles(projectFolder, mode, features, onProgress) {
             removedDirs.push(...definition.paths);
         }
     }
-    patchPackageJsonCanton(projectFolder, removedDirs);
+    const precommitRemoved = mode !== 'full' && !isFeatureSelected('precommit', features);
+    patchPackageJsonCanton(projectFolder, removedDirs, precommitRemoved);
 }
 export async function cleanupFiles(stack, projectFolder, mode, features = [], onProgress) {
-    await cleanupRepositoryHygiene(stack, projectFolder, onProgress);
     if (stack === 'canton') {
         await cleanupCantonFiles(projectFolder, mode, features, onProgress);
         onProgress?.('Initial commit');
         await createInitialCommit(projectFolder);
         return;
     }
+    await cleanupRepositoryHygiene(projectFolder, onProgress);
     await cleanupEvmFiles(projectFolder, mode, features, onProgress);
 }

package/dist/types/types.d.ts

@@ -3,7 +3,7 @@ export type SelectItem = {
     value: string;
 };
 export type MultiSelectItem = SelectItem;
-export type InstallationType = 'full' | 'custom';
+export type InstallationType = 'full' | 'default' | 'custom';
 export type InstallationSelectItem = {
     label: string;
     value: InstallationType;

package/dist/utils/utils.d.ts

@@ -1,4 +1,5 @@
 import { type FeatureName, type Stack } from '../constants/config.js';
+import type { InstallationType } from '../types/types.js';
 export declare function getProjectFolder(projectName: string): string;
 export declare function isValidName(name: string): boolean;
 export declare function isAnswerConfirmed(answer?: string, errorMessage?: string): boolean;
@@ -7,9 +8,10 @@ export declare function isFeatureSelected(feature: FeatureName, selectedFeatures
 type FeatureToggleAction = 'select' | 'unselect';
 export declare function resolveSelectedFeatures(stack: Stack, selectedFeatures: FeatureName[]): FeatureName[];
 export declare function applyFeatureToggle(stack: Stack, selectedFeatures: FeatureName[], toggledFeature: FeatureName, action: FeatureToggleAction): FeatureName[];
-export declare function describeInstallPlan(stack: Stack, projectName: string, mode: 'full' | 'custom', selectedFeatures: FeatureName[]): string;
+export declare function describeInstallPlan(stack: Stack, projectName: string, mode: InstallationType, selectedFeatures: FeatureName[]): string;
 export declare function getPackagesToRemove(stack: Stack, selectedFeatures: FeatureName[]): string[];
-export declare function getPostInstallMessages(stack: Stack, mode: 'full' | 'custom', selectedFeatures: FeatureName[]): string[];
+export declare function getPostInstallMessages(stack: Stack, mode: InstallationType, selectedFeatures: FeatureName[]): string[];
+export declare function resolveModeFeatures(stack: Stack, mode: InstallationType, customSelection?: FeatureName[]): FeatureName[];
 export declare function projectDirectoryExists(projectName: string): boolean;
 type StepStatus = 'running' | 'done' | 'error';
 type StepDisplay = {

package/dist/utils/utils.js

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import process from 'node:process';
-import { getFeatureNames, getStackConfig, } from '../constants/config.js';
+import { getDefaultFeatureNames, getFeatureNames, getStackConfig, } from '../constants/config.js';
 export function getProjectFolder(projectName) {
     return join(process.cwd(), projectName);
 }
@@ -68,6 +68,9 @@ export function describeInstallPlan(stack, projectName, mode, selectedFeatures)
     if (mode === 'full') {
         return `${head} · Mode: full (all features)`;
     }
+    if (mode === 'default') {
+        return `${head} · Mode: default (recommended)`;
+    }
     const features = selectedFeatures.length > 0 ? selectedFeatures.join(', ') : 'none';
     return `${head} · Mode: custom · Features: ${features}`;
 }
@@ -78,11 +81,24 @@ export function getPackagesToRemove(stack, selectedFeatures) {
         .flatMap(([, def]) => def.packages);
 }
 export function getPostInstallMessages(stack, mode, selectedFeatures) {
-    const features = getStackConfig(stack).features;
+    const config = getStackConfig(stack);
+    const features = config.features;
+    const stackLevel = config.postInstall ?? [];
+    const kept = resolveModeFeatures(stack, mode, selectedFeatures);
+    const featureMessages = kept.flatMap((name) => features[name]?.postInstall ?? []);
+    return [...stackLevel, ...featureMessages];
+}
+// Resolves the kept-feature list for a mode: full → all, default → default:true set,
+// custom → the user's selection (transitive requires resolved). Shared by the non-interactive
+// path and the interactive Install/FileCleanup/PostInstall steps.
+export function resolveModeFeatures(stack, mode, customSelection = []) {
     if (mode === 'full') {
-        return Object.values(features).flatMap((def) => def.postInstall ?? []);
+        return getFeatureNames(stack);
+    }
+    if (mode === 'default') {
+        return getDefaultFeatureNames(stack);
     }
-    return selectedFeatures.flatMap((name) => features[name]?.postInstall ?? []);
+    return resolveSelectedFeatures(stack, customSelection);
 }
 export function projectDirectoryExists(projectName) {
     return existsSync(getProjectFolder(projectName));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dappbooster",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "description": "Agent-friendly dAppBooster installer that scaffolds Web3 dApps via TUI or non-interactive CLI/CI.",
   "keywords": [
     "dappbooster",
@@ -39,9 +39,7 @@
     "lint": "pnpm biome check",
     "lint:fix": "pnpm biome check --write"
   },
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "dependencies": {
     "figures": "^6.1.0",
     "ink": "^5.2.1",

package/readme.md

@@ -7,7 +7,7 @@ agents.
 
 - **EVM** — the original [dAppBooster](https://dappbooster.dev/) for Ethereum, Polygon, Base, and
   other EVM chains.
-- **Canton** — [dAppBooster for Canton](https://dappbooster-canton-landing.vercel.app/): Daml
+- **Canton** — [dAppBooster for Canton](https://www.dappbooster.cc/): Daml
   ledger, Carpincho wallet, off-chain services.
 
 ## Choose your stack
@@ -33,8 +33,9 @@ Omit the flag to be prompted for the stack in the wizard. Jump to the [EVM stack
 pnpm dlx dappbooster
 ```
 
-The wizard prompts for stack → project name → mode (full / custom) → features, then clones,
-installs, cleans up, and prints next steps. Pass `--evm` or `--canton` to skip the stack prompt.
+The wizard prompts for stack → project name → mode (Canton offers default / full / custom; EVM
+offers full / custom) → features, then clones, installs, cleans up, and prints next steps. Pass
+`--evm` or `--canton` to skip the stack prompt.
 
 dAppBooster documentation: https://docs.dappbooster.dev/
 
@@ -55,7 +56,7 @@ pnpm dlx dappbooster --info --stack canton   # filter to one stack (or --info --
 | `--canton` / `--evm` | Pick the stack (mutually exclusive shortcuts) |
 | `--stack <evm\|canton>` | Pick the stack by name (useful when scripting) |
 | `--name <name>` | Project directory name (`/^[a-zA-Z0-9_]+$/`) |
-| `--mode <full\|custom>` | `full` installs every feature; `custom` needs `--features` |
+| `--mode <full\|default\|custom>` | `default` (Canton only) keeps the recommended set; `full` installs every feature; `custom` needs `--features` |
 | `--features <a,b,c>` | Comma-separated feature keys (custom mode only) |
 | `--ni` | Force non-interactive mode |
 
@@ -65,7 +66,7 @@ accepts only its own feature keys, and validation errors name the stack:
 ```json
 {
   "success": false,
-  "error": "Unknown features for stack 'canton': subgraph. Valid features: counter, e2e, carpincho, llm"
+  "error": "Unknown features for stack 'canton': subgraph. Valid features: github, precommit, carpincho, llm"
 }
 ```
 
@@ -79,7 +80,7 @@ A successful install prints:
   "success": true,
   "stack": "evm|canton",
   "projectName": "...",
-  "mode": "full|custom",
+  "mode": "full|default|custom",
   "features": ["..."],
   "path": "/absolute/path",
   "postInstall": ["..."]
@@ -131,51 +132,63 @@ pnpm dlx dappbooster --canton
 Interactive (skips the stack prompt) or non-interactive:
 
 ```shell
-pnpm dlx dappbooster --canton --ni --name my_canton_dapp --mode full
-pnpm dlx dappbooster --canton --ni --name my_canton --mode custom --features counter,carpincho
+pnpm dlx dappbooster --canton --ni --name my_canton_dapp --mode default
+pnpm dlx dappbooster --canton --ni --name my_canton --mode custom --features carpincho,github
 ```
 
 | Feature | Key | Default | Description |
 |---|---|---|---|
-| Counter demo | `counter` | ✓ | Counter demo dapp (frontend + Daml + wallet-service) |
-| E2E tests | `e2e` | ✓ | Playwright end-to-end test suite (**requires `counter`**) |
+| GitHub templates & workflows | `github` |  | GitHub issue/PR templates and workflows (`.github`) |
+| Pre-commit hooks | `precommit` |  | Husky, lint-staged, and commitlint |
 | Carpincho wallet | `carpincho` | ✓ | Carpincho browser-extension wallet (frontend + build tooling) |
 | LLM & agent artifacts | `llm` | ✓ | `.claude`, `AGENTS.md`, `CLAUDE.md`, `architecture.md`, `llms.txt`, … |
 
-`e2e` drives the counter dapp, so it **requires** `counter`: requesting `--features e2e` auto-pulls
-`counter` in (the success JSON reports `["counter", "e2e"]`), and in the wizard, deselecting
-`counter` also unchecks `e2e`.
+`default` mode (the recommended Canton install) keeps `carpincho` + `llm` and removes `github` +
+`precommit`; `full` keeps all four; `custom` lets you pick (in the wizard `github` and `precommit`
+start unchecked). To remove the demo features (`counter`, `sign-message`) after scaffolding, follow
+the "Removing a feature" guide in the generated `dapp/frontend/README.md` — the installer never
+deletes demo source itself.
 
 The Canton scaffold uses **npm** (a property of the generated project, not this installer). After
-install: review `canton-barebones/.env`, run `npm run canton:up` to start the local Canton stack,
-and `npm run app:dev` to run the counter dapp frontend. When `carpincho` is included, build the
-extension with `npm run carpincho:build:extension` and load `carpincho-wallet/dist-extension` as an
-unpacked browser extension.
+install, review `canton-barebones/.env`, then bring the whole local stack up with a single command:
+`./scripts/dev-stack.sh up` (Docker must be running). It starts the Canton + Postgres +
+wallet-service containers, runs the health checks, builds and deploys the quickstart-counter DAR,
+launches the dapp frontend (`:3012`), and — when `carpincho` is included — builds the Carpincho
+extension and copies it to `~/Desktop/dist-extension` (load it via `chrome://extensions`, Developer
+mode → Load unpacked). Run `./scripts/dev-stack.sh` with no arguments for an interactive arrow-key
+menu; `mock-up` brings up a Docker-free mocked wallet-service + Carpincho web app, and `down` tears
+everything back down.
+
+Prefer to run the pieces by hand? The underlying npm scripts still work: `npm run canton:up` to
+start the local Canton stack and `npm run app:dev` for the dapp frontend, and when `carpincho` is
+included build the extension with `npm run carpincho:build:extension` and load
+`carpincho-wallet/dist-extension` as an unpacked browser extension.
 
 **What gets stripped:**
 
-- **Always** (every stack and mode): CI config (`.github`) and the husky/commitlint automation
-  (`.husky`, `.lintstagedrc.mjs`, `commitlint.config.js`), plus their entries in the root
-  `package.json`.
-- **Per feature** (custom mode): deselecting a feature removes its files and any `package.json`
-  scripts that target them — deselecting `carpincho` removes `carpincho-wallet/` and its scripts
-  (`wallet:dev`, `carpincho:build:extension`); deselecting `llm` removes the agent docs.
-- A **full** install keeps all four features — including `carpincho-wallet/` and the agent docs.
+- **EVM** always removes CI config (`.github`) and the husky/commitlint automation as hygiene.
+- **Canton** treats `.github` and pre-commit hooks as optional features: `default` mode removes
+  both; `full` keeps both; `custom` removes whichever you uncheck. Deselecting `carpincho` removes
+  `carpincho-wallet/` and its scripts (`wallet:dev`, `carpincho:build:extension`); deselecting `llm`
+  removes the agent docs. Removing `precommit` also strips the `prepare` script and the
+  husky/lint-staged/commitlint dev-dependencies from the root `package.json`.
+- The Canton installer never deletes demo source (the `counter`/`sign-message` features) — that is
+  user-controlled via the template's `dapp/frontend/README.md`.
 
 ```json
 {
   "success": true,
   "stack": "canton",
   "projectName": "my_canton_dapp",
-  "mode": "full",
-  "features": ["counter", "e2e", "carpincho", "llm"],
+  "mode": "default",
+  "features": ["carpincho", "llm"],
   "path": "/absolute/path/to/my_canton_dapp",
   "postInstall": [
     "Review canton-barebones/.env (created from the example)",
-    "Run npm run canton:up to start the local Canton stack",
-    "Run npm run app:dev to start the counter dapp frontend",
-    "Build the Carpincho extension with npm run carpincho:build:extension",
-    "Load carpincho-wallet/dist-extension as an unpacked browser extension"
+    "Run ./scripts/dev-stack.sh up to bring up the whole local stack in one command — Docker must be running (run ./scripts/dev-stack.sh with no arguments for an interactive menu)",
+    "Fallback — start each piece manually: npm run canton:up for the Canton stack, then npm run app:dev for the dapp frontend",
+    "./scripts/dev-stack.sh up also builds the Carpincho extension and copies it to ~/Desktop/dist-extension (load it via chrome://extensions, Developer mode -> Load unpacked)",
+    "Fallback — build it manually with npm run carpincho:build:extension, then load carpincho-wallet/dist-extension as an unpacked browser extension"
   ]
 }
 ```