SUPERKIT 🚀

Build high-performance apps swiftly with minimal team resources in Go.

SUPERKIT is a full-stack web framework designed for speed and simplicity. It provides essential tools and libraries to help developers build modern web applications with ease.

⚠️ Currently in Experimental Phase

---

📖 Table of Contents

• 🌟 Features
• 📥 Installation
• 🚀 Getting Started
  • 📂 Project Structure
  • 🎮 Development Server
  • 🔥 Hot Reloading
• 📊 Database Migrations
• 🛠 Creating Views with Templ
• ✅ Validations
• 🧪 Testing
• 📦 Production Release

---

🌟 Features

✅ Lightweight & Fast – Built on Go for blazing-fast performance.
✅ Modular Design – Well-structured and easy to extend.
✅ Built-in Database Support – Migrations, seeds, and ORM included.
✅ Templ-based Views – Type-safe templating engine for UI components.
✅ Hot Reloading – Instant feedback during development.
✅ One-Binary Deployment – Compiles your app into a single executable.

---

📥 Installation

Create a new SUPERKIT project with a single command:

# Initialize a new SUPERKIT project
go run github.com/khulnasoft/superkit@master [yourprojectname]

# Navigate into your project
cd [yourprojectname]

# Install TailwindCSS & esbuild
npm install

# Resolve Go dependencies
go clean -modcache && go get -u ./...

# Initialize database migrations (if authentication plugin is enabled)
make db-up

---

🚀 Getting Started

📂 Project Structure

├── bootstrap
│   ├── app
│   │   ├── assets  # Static files (CSS, JS)
│   │   ├── conf    # Configuration files
│   │   ├── db      # Database migrations
│   │   ├── events  # Custom event handlers
│   │   ├── handlers # Request handlers (controllers)
│   │   ├── types   # Data models and interfaces
│   │   ├── views   # HTML templates
│   ├── cmd
│   │   ├── scripts # CLI commands & seed scripts
│   ├── plugins
│   │   ├── auth    # Authentication module
├── public         # Public assets
├── kit            # Core framework utilities
├── validate       # Validation utilities
├── view           # View engine utilities
├── Makefile       # Build & run scripts
├── go.mod         # Go dependencies
├── README.md      # Project documentation

---

🎮 Development Server

Run the development server:

make dev

---

🔥 Hot Reloading

Hot reloading is enabled by default for CSS & JS.

Note: On Windows (WSL2), you might need to run this command separately:

make watch-assets

---

📊 Database Migrations

Create a New Migration

make db-mig-create add_users_table

➡️ Generates a new migration SQL file in app/db/migrations/

Apply Migrations

make db-up

Reset the Database

make db-reset

Seed the Database

make db-seed

➡️ Runs the seed script in cmd/scripts/seed/main.go

---

🛠 Creating Views with Templ

SUPERKIT uses Templ for type-safe UI components.
Create structured, reusable HTML fragments with Go templates.

---

✅ Validations (Coming Soon)

Stay tuned for built-in validation utilities!

---

🧪 Testing

Test Handlers

make test

➡️ Runs automated tests for controllers & business logic.

---

📦 Production Release

Compile your application into a single binary:

make build

➡️ Creates a production-ready binary at /bin/app_prod.

Set the environment to production:

SUPERKIT_ENV=production

---

🚀 Start building with SUPERKIT today! 💙