ecopages CLI

The ecopages npm package is the official and preferred command-line tool for scaffolding and running Ecopages projects.

It is best when you want:

• Fast project creation from templates
• Consistent Bun commands (dev, build, preview, start)
• A single entrypoint for common local workflows

Install

You can run the CLI directly with bunx (no global install required):

bunx ecopages --help

Or install it in a project:

bun add ecopages

Initialize Projects

Interactive Init

Use the base init command when you want to pick options interactively:

bunx ecopages init

One-Shot Commands (Complete)

Use these when you want a full bootstrap in one command chain.

Basic starter - Creates a minimal Ecopages app with default setup. Example: starter-jsx.

bunx ecopages init ecopages-app && cd ecopages-app && bun install && bun dev

Blog with KitaJS - Creates a content-focused blog using the blog-jsx template. Example: blog-jsx.

bunx ecopages init blog-jsx --template blog-jsx && cd blog-jsx && bun install && bun dev

Blog with React - Creates a React-powered blog with routing preconfigured. Example: blog-react.

bunx ecopages init blog-react --template blog-react && cd blog-react && bun install && bun dev

React app with Better Auth + Drizzle - Creates a full app starter with auth and database workflow included. Example: with-react-better-auth.

bunx ecopages init with-react-better-auth --template with-react-better-auth && cd with-react-better-auth && bun install && bun db:generate && bun db:migrate && bun dev

Step-by-Step (Individual)

1) Basic starter

bunx ecopages init ecopages-app
cd ecopages-app
bun install
bun dev

2) Blog with KitaJS

bunx ecopages init blog-jsx --template blog-jsx
cd blog-jsx
bun install
bun dev

3) Blog with React

bunx ecopages init blog-react --template blog-react
cd blog-react
bun install
bun dev

4) React app with Better Auth + Drizzle

bunx ecopages init with-react-better-auth --template with-react-better-auth
cd with-react-better-auth
bun install
bun db:generate
bun db:migrate
bun dev

Command Details

This page focuses on setup and project bootstrapping.

For the complete command, flag, and environment variable reference, see CLI Reference.

When To Use ecopages vs JSR Packages

• Use ecopages CLI for scaffolding and local app lifecycle commands.
• Use @ecopages/* packages from JSR for framework APIs in app code.

For the complete package map, see Ecosystem Packages.