Vite Beam

💡 Instant Setup
⚡️ Lightning Fast Workflow
🛠️ Automated GitHub Actions
📦 Zero-Config Build & Deploy
🔩 Universal Vite Support
🔑 Fully Typed CLI Integration

Vite Beam (pronounced /viːt biːm/) is a lightweight developer experience (DevEx) CLI tool designed to automate the scaffolding, configuration, and continuous deployment of Vite-powered web applications directly to GitHub Pages.

It bridges the gap between your local terminal and GitHub cloud infrastructure in seconds:

1. Automated Repository & CI/CD Pipeline: Scaffolds, configures, and commits standard GitHub Actions workflow files (deploy.yml), project base paths, and workspace permissions automatically.
2. Instant Deployment Toolchain: Handles git initializations, dependency installations, and automated remote repository sync with a single command.

🚀 Quick Start

Run Vite Beam in your terminal to initialize and deploy your Vite project in one smooth step:

npx vite-beam <my-app-name>

✨ Features

• ⚡ Zero-Touch GitHub Pages Deployment: Sets up full GitHub Actions runner workflows out of the box.
• 🔒 Automated Permissions: Configures contents: write and pages: write workflows automatically.
• 🎯 Dynamic Base Pathing: Auto-detects repository names and sets base in vite.config.ts.
• 📟 Clean Visual Output: Detailed step-by-step progress logging with ANSI ASCII completion banners.

🛠️ Requirements

• Node.js 18.x or higher
• Git installed on your system