A lightning-fast, interactive CLI for creating new GWA projects.
gwa-cli is the official command-line tool for scaffolding a new General Web App (GWA) project. It provides an interactive experience to configure your new project, allowing you to select components, define names, and set up database credentials before generating all the necessary files from the GWA template.
This tool handles all the heavy lifting, so you can go from an empty directory to a fully structured, ready-to-run, full-stack application in seconds.
✨ Features
- Interactive Mode: A guided, user-friendly process to configure every aspect of your new project.
- Modular Component Selection: Choose to include the Backend (FastAPI), Frontend (SvelteKit + Tauri), or both.
- Intelligent Defaults: Sensible defaults are provided for all settings, speeding up creation.
- Fast-Track Mode: Skip all prompts with a
--yesflag for rapid, non-interactive project generation. - Powered by Rust: Fast, reliable, and packaged as a single native binary.
🚀 Getting Started
Prerequisites
You must have Rust and Cargo installed on your system to build and install gwa-cli.
Installation
You can install the gwa binary directly from this source repository using cargo.
This command will build the project in release mode and place the gwa executable in your Cargo binary path (~/.cargo/bin/), making it available system-wide.
Verify the installation:
🛠️ Usage
The primary command is gwa create.
Interactive Creation (Recommended)
To start the interactive setup wizard, simply run:
The CLI will guide you through a series of questions:
- Project Name (if not provided)
- Component Selection (Backend / Frontend)
- Application Identifiers (for Tauri)
- Database Configuration
After you confirm the summary, it will generate the project in a new directory named <your-project-name>.
Non-Interactive Creation
For automated scripts or quick tests, you can use the --yes (-y) flag. This will skip all interactive prompts and use the default configuration.
Note: In non-interactive mode, the project name is a required argument.
This will instantly create a new project named my-new-app with both backend and frontend components included.
Command-Line Options
Here are the details for the create command:
gwa create [OPTIONS] [NAME]
📄 License
This project is licensed under the MIT License. See the LICENSE file for details.