Installation
Install RapidGo and create your first project.
Requirements
- Go 1.25 or later
- Git
- A database: SQLite (zero config), PostgreSQL, or MySQL
Option 1: CLI (Recommended)
Install the RapidGo CLI globally:
go install github.com/raiworks/rapidgo/v2/cmd/rapidgo@latest
Create a new project:
rapidgo new myapp
cd myapp
The CLI downloads the RapidGo Starter template, renames the Go module to your project name, and runs go mod tidy.
Option 2: Clone the Starter
git clone https://github.com/raiworks/rapidgo-starter.git myapp
cd myapp
Update the module path in go.mod and all import statements:
# Replace the module name in go.mod
go mod edit -module github.com/yourname/myapp
# Update all imports (use sed, IDE refactor, or find-and-replace)
go mod tidy
First Run
cp .env.example .env # Create your environment config
go run cmd/main.go migrate # Run database migrations
go run cmd/main.go db:seed # Seed default data
go run cmd/main.go serve # Start the server
Visit http://localhost:8080 — your RapidGo app is running.
Framework vs Starter
Framework (rapidgo) |
Starter (rapidgo-starter) |
|
|---|---|---|
| What | The library — 29 core packages | Your application scaffold |
| Import | github.com/raiworks/rapidgo/v2 |
Your own module path |
| You edit | Never | Everything |
| Contains | Router, ORM, auth, queue, etc. | Routes, controllers, models, views |