1. Create an app

Create the projectCopy Anchor Link

npm create @bitakit/app@latest my-app -- --framework next --features none --yes

The generator creates my-app, connects BitaKit to Next.js and installs the dependencies with the package manager that ran it. --features none keeps this first app minimal; without the options it asks what to include and defaults to a complete frame (Shell, Settings and Quick Search). To use the folder you already have open, for example in a coding agent, write . instead of my-app.

Start itCopy Anchor Link

cd my-app
npm run dev

Open the address the terminal prints. You see Welcome.

Make one changeCopy Anchor Link

Replace src/app/page.tsx with:

'use client';
import { PageHeader } from '@bitakit/ui/components';

export default function Home() {
  return <PageHeader title="My first app" />;
}

The page now says My first app. Leave the generated provider and configuration as they are.

Check the projectCopy Anchor Link

In a second terminal, in my-app:

npm run typecheck

npx bitakit doctor

typecheck generates the plugin types (src/bitakit.gen.*) and checks your code. doctor reports wiring problems with the fix. npx bitakit runs the CLI installed in the project with any package manager.