✨ vibe

Minimalist Project Scaffolding Engine

Scaffold projects at the speed of thought. Zero-config, beautiful starter kits.

📑 Table of Contents

• 🌟 Overview
• 🚀 Enterprise Features
• ⚡ Quick Start Guide
• 💻 Comprehensive Usage
• 🤝 Contributing

🌟 Overview

vibe is a blazing-fast project scaffolding CLI tool built to safeguard your flow state. Stop spending hours wiring up complex configurations before you even start coding. Just run a single command, choose a beautiful template, and start building.

🚀 Enterprise Features

• 🎨 Beautiful TUI: Built with Typer and Rich for a stunning visual experience directly in your terminal. No ugly text prompts.
• ⚡ Zero Config: Generates projects with zero configuration needed. Eslint, Prettier, TypeScript, and Docker are automatically configured.
• 🚀 Instant Starters: Generates full-stack React, FastAPI, or Node templates perfectly tuned for modern Vibe Coders.
• 🪶 Unopinionated Defaults: Focuses entirely on lightweight, dependency-free architecture without pushing you into restrictive frameworks.

⚡ Quick Start Guide

Installation

Install directly via pip:

pip install vibe-scaffold

Or install via pipx or uv:

pipx install vibe-scaffold
# or
uv tool install vibe-scaffold

💻 Comprehensive Usage

Scaffold a New Project

Provide your project name and let the engine scaffold everything for you:

vibe my-new-project

By default, this will use the react template.

Use a Direct Template Flag

Provide the template flag to scaffold instantly in CI/CD pipelines:

vibe api-service --template fastapi
vibe frontend-app --template react

🤝 Contributing

Want to add a new beautiful template or improve the TUI? We'd love your help! 💖

• 🐛 Found a bug? Open an issue to let us know.
• ✨ Have a template idea? We are open to PRs! Just make sure to run tests and keep the CLI vibrant.
• 🎨 Documentation tweaks? Always welcome!

Built by a Vibe Coder. Let the flow begin.