create-gea

Scaffold a new Gea app with Vite in seconds.

Usage

npm create gea@latest my-app

Or with other package managers:

pnpm create gea@latest my-app
yarn create gea@latest my-app
bun create gea@latest my-app

If you omit the project name, you'll be prompted for one (defaults to gea-app).

To scaffold into the current directory:

npm create gea@latest .

The target directory must be empty.

What Gets Scaffolded

my-app/
  index.html              HTML entry point
  package.json            Dependencies: @geajs/core, vite, @geajs/vite-plugin, typescript
  vite.config.ts          Vite config with geaPlugin()
  tsconfig.json           TypeScript configuration
  .gitignore              Standard ignores
  src/
    main.ts               App bootstrap — creates and renders the root component
    app.tsx               Root class component composing CounterPanel and CounterNote
    counter-store.ts      Store with count state, increment/decrement methods
    counter-panel.tsx     Class component with +/- buttons
    counter-note.tsx      Function component displaying the count
    styles.css            Project styles

The template demonstrates:

• A store with reactive state and mutation methods
• A class component with JSX, store integration, and child components
• A function component receiving props
• The Vite plugin handling JSX transforms and HMR

After Scaffolding

cd my-app
npm install
npm run dev

The scaffolder detects your package manager (npm, pnpm, yarn, or bun) and prints the correct commands.

Related Packages

• @geajs/core — Core framework
• @geajs/vite-plugin — Vite plugin
• @geajs/mobile — Mobile UI primitives

License

MIT — Copyright (c) 2017-present Armagan Amcalar