Webpresso

create-webpresso

Scaffold a new Webpresso project with a single command. Choose from production-ready templates for React, Next.js, Express, FastAPI, and Go.

Installation

No installation required. Run directly with npx, pnpm dlx, or bunx:

Terminal
# Using npx (npm)
npx create-webpresso my-app

# Using pnpm
pnpm dlx create-webpresso my-app

# Using bun
bunx create-webpresso my-app

Usage

Interactive Mode

Run without arguments for an interactive experience that guides you through template selection:

Terminal
npx create-webpresso my-app

With Template Flag

Skip the prompt by specifying a template directly:

Terminal
# React + Vite
npx create-webpresso my-app --template react-vite

# Next.js
npx create-webpresso my-app --template nextjs-app

# Express
npx create-webpresso my-app --template express-ts

# FastAPI
npx create-webpresso my-app --template fastapi

# Go + Chi
npx create-webpresso my-app --template go-chi

Options

OptionDescriptionDefault
--template, -tTemplate to useInteractive prompt
--no-gitSkip git initializationfalse
--no-installSkip dependency installationfalse

Templates

react-vite

Modern React development with Vite's blazing-fast HMR.

  • React 19 with TypeScript
  • Vite 6 with Hot Module Replacement
  • Tailwind CSS v3
  • ESLint + Biome for linting

nextjs-app

Full-stack React framework with App Router.

  • Next.js 15 with App Router
  • React Server Components
  • TypeScript strict mode
  • Tailwind CSS
  • Turbopack for development

express-ts

Production-ready Express API with TypeScript.

  • Express 4 with TypeScript
  • ESLint configuration
  • Docker-ready with multi-stage build
  • Health check endpoint

fastapi

High-performance Python API framework.

  • FastAPI with Python 3.12
  • uvicorn ASGI server
  • Pydantic v2 for validation
  • Auto-generated OpenAPI docs
  • Docker-ready

go-chi

Lightweight Go API with Chi router.

  • Go 1.23
  • Chi router with middleware
  • Graceful shutdown
  • Zero external dependencies (except Chi)
  • Docker-ready with multi-stage build

What's Included

Each template comes with:

  • TypeScript (for JS templates) — Strict mode enabled
  • Docker (for backend templates) — Production-ready Dockerfile
  • Git — Initialized with first commit
  • README — Getting started instructions

Examples

Terminal
# Create a React app
npx create-webpresso my-react-app --template react-vite

# Create a FastAPI backend
npx create-webpresso my-api --template fastapi

# Create without git or installing deps
npx create-webpresso my-app --template express-ts --no-git --no-install