Svelte + Go Echo Starterkit

A production-ready e-commerce starter kit with SvelteKit frontend and Go Echo backend.

Features

• Authentication: JWT-based with dual scope (internal/customer), OTP-ready
• Role System: Admin, Manager, Staff, Customer with granular permissions
• Activity Logs: Full audit trail for all actions
• Payment Gateway: Pluggable interface (ready for Duitku, Midtrans, etc.)
• Theme System: Dark/light mode with customizable primary color
• E-Commerce Core: Products, Orders, Users management

Tech Stack

Quick Start

Prerequisites

• Go 1.21+
• Node.js 18+
• PostgreSQL (optional, SQLite works for dev)

Backend Setup

cd backend

# Copy environment file
cp .env.example .env

# Edit .env with your settings
# DATABASE_URL=./data/starterkit.db  (SQLite for dev)
# DATABASE_URL=postgres://user:pass@host:5432/db  (PostgreSQL for prod)
# JWT_SECRET=change-this-to-a-secure-random-string

# Install dependencies
go mod tidy

# Run database migrations (creates tables)
go run cmd/main.go -migrate

# Seed default data (admin user)
go run cmd/main.go -seed

# Start development server
make dev
# or
go run cmd/main.go

Backend runs on: http://localhost:3078

Frontend Setup

cd frontend

# Install dependencies
npm install

# Start development server
npm run dev

Frontend runs on: http://localhost:5173

Default Credentials

After seeding:

Important: Change these immediately in production!

Project Structure

svelte-go-starterkit/
├── backend/
│   ├── cmd/main.go           # Entry point
│   ├── internal/
│   │   ├── config/           # Configuration
│   │   ├── handler/          # HTTP handlers (in service package)
│   │   ├── middleware/       # Auth, Role middleware
│   │   ├── model/           # Database models
│   │   ├── repository/       # Data access layer
│   │   ├── service/          # Business logic
│   │   └── payment/         # Payment gateway interface
│   └── pkg/utils/            # Shared utilities
│
└── frontend/
    └── src/
        ├── lib/
        │   ├── api/          # API client
        │   ├── stores/       # Svelte stores (auth, theme)
        │   └── components/   # UI components
        └── routes/
            ├── +page.svelte  # Landing page
            ├── (auth)/        # Login, Register
            ├── (app)/         # Customer dashboard
            └── admin/         # Admin panel

API Endpoints

Public

Customer (Authenticated)

Admin (Authenticated)

Role Permissions

OTP Configuration

OTP can be enabled via settings:

# In admin settings panel or directly in database:
otp_enabled = true
otp_provider = whatsapp  # or email, sms

Theme Customization

Users can customize the theme via settings:

{
  "ui_theme_mode": "dark" | "light",
  "ui_theme_primary": "#0ea5e9"
}

Available color presets: Sky, Blue, Pink, Violet, Rose, Emerald, Amber, Orange

Development

Running Tests

# Backend
cd backend
go test ./...

# Frontend
cd frontend
npm run test

Building for Production

# Backend
cd backend
make build
# Binary: bin/server

# Frontend
cd frontend
npm run build
# Output: frontend/build/

License

MIT