Scaffolding your first Ionify project

Ionify’s recommended starting point is the scaffolder:

npm create ionify@latest

pnpm create ionify@latest

yarn create ionify

bunx create-ionify@latest

It generates a ready-to-run app (optional monorepo + testing presets + smart defaults).

Manual installation

1) Install the CLI

npm i -D @ionify/ionify

pnpm add -D @ionify/ionify

yarn add -D @ionify/ionify

bun add -d @ionify/ionify

2) Create ionify.config.ts

import { defineConfig } from "@ionify/ionify";

export default defineConfig({
  entry: "/src/main.tsx",
  optimizeDeps: {
    sharedChunks: "auto",
    vendorPacks: "auto",
    packSlimming: "auto",
  },
});

3) Run

npx ionify dev
npx ionify build
npx ionify analyze

pnpm ionify dev
pnpm ionify build
pnpm ionify analyze

yarn ionify dev
yarn ionify build
yarn ionify analyze

bunx ionify dev
bunx ionify build
bunx ionify analyze

Notes

• entry supports project-relative paths (/src/... is supported).
• In a workspace/monorepo, Ionify stores .ionify/ at the workspace root to share Graph/CAS/deps across apps.
• If something looks stale during development, deleting .ionify/ is the “reset” button.
• See Configs for the full surface (packs, slimming, env handling).