Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install pepino

It will make the pepino command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall pepino uninstalls.

Back to the crate overview.

Readme

Pepino 🥒

A fullstack scaffolder for modern Rust + TypeScript web applications

Axum backend • React frontend • Shared types • SQLite or Postgres

Stop configuring, start building.

Prerequisites

Install these tools before starting:

# Install just
cargo install just

# Install sqlx-cli
cargo install sqlx-cli --no-default-features --features postgres

# Install typeshare-cli
cargo install typeshare-cli

# Install cargo-watch (optional, for hot reload)
cargo install cargo-watch

What You Get

Pepino generates a complete, production-ready fullstack project

Backend: Axum + SQLx with example CRUD endpoints
Frontend: React + Vite + TanStack Query
Type Safety: Rust types auto-generate TypeScript interfaces
Database: Choose PostgreSQL or SQLite with migrations included
Dev Tools: Hot reload, justfile commands, structured error handling
Working Example: Full user management flow out of the box

Available Commands

Once your project is generated, use these just commands:

# Database (Docker)
just db-up           # Start PostgreSQL
just db-down         # Stop PostgreSQL
just install         # install server and vite packages
just dev-server      # Start Rust backend with hot reload
just dev-client      # Start Vite dev server
just migrate         # Run database migrations
just generate-types  # Generate TS types from Rust
just build          # Build for production
just clean          # Clean build artifacts
just test           # Run tests

Roadmap

⏳ Actix-web backend option
⏳ Diesel ORM option
⏳ Authentication scaffolding
⏳ Docker configuration
⏳ CI/CD templates

Contributing

License

MIT • Nkemjika