Atomic Install

Install and configure create-atomic-resources and atomic-bomb together.

Usage

Run from an application root containing package.json:

npx create-atomic-install@latest ./src

Defaults:

• resource destination: ./src
• Atomic Bomb platform: react-ts-vite
• package versions: @latest

The equivalent default command is:

npx create-atomic-install@latest

What It Does

1. Detects npm, Yarn, or pnpm from the project lockfile.

2. Adds atomic-bomb@latest and create-atomic-resources@latest as development dependencies.

3. Runs exactly:

   npx --yes create-atomic-resources@latest ./src

4. If .atomic-bomb is missing, runs:

   printf 'N\n' | npx --yes atomic-bomb@latest --platform react-ts-vite

   The installer declines optional AI provider configuration.

5. If .atomic-bomb exists, runs:

   npx --yes atomic-bomb@latest --update

6. Asks whether Storybook should be installed with:

   npx sb init --yes --no-dev

   Storybook uses its defaults and exits after initialization without starting the development server.

7. For web projects, updates .storybook/preview.ts, .storybook/preview.js, storybook/preview.ts, or storybook/preview.js, when present, to import the generated resources/styles/main.css from the configured resource destination.

8. For web projects, enables the Atomic Bomb component Sass imports in <destination>/resources/styles/main.scss.

9. For Expo or React Native projects, keeps the native token script and wires the generated useFont hook into App.tsx when possible.

10. Rewrites the generated resource scripts and .atomic-bomb component destination to use the destination passed to this installer.

The explicit create-atomic-resources@latest package specifier is intentional. It avoids stale npx resolution and is used on every resource installation.

For local end-to-end testing, override the package specifiers with environment variables:

ATOMIC_BOMB_PACKAGE=/Users/rene/Development/krewinkel/atomic/atomic-bomb \
CREATE_ATOMIC_RESOURCES_PACKAGE=/Users/rene/Development/krewinkel/atomic/create-atomic-resources \
npx create-atomic-install ./src

Options

--platform <name>        Atomic Bomb platform (default: react-ts-vite)
--storybook              Install Storybook without prompting
--skip-storybook         Do not install Storybook or prompt
--skip-resources         Do not run create-atomic-resources
--skip-atomic-bomb       Do not install or configure atomic-bomb
--skip-dependencies      Do not add the CLI packages to devDependencies
--skip-update            Do not refresh Atomic Bomb skills when configured
-h, --help               Show help

Examples:

npx create-atomic-install@latest ./src --platform react-ts-vite
npx create-atomic-install@latest ./src --storybook
npx create-atomic-install@latest ./app --skip-atomic-bomb
npx create-atomic-install@latest --skip-resources

Atomic Bomb platform setup is non-interactive and leaves the optional AI provider disabled.