Technology Stack

​

Overview

​

Backend Stack

​

Core Framework

​

Go (Golang) 1.25.0

• Excellent performance and concurrency
• Strong type system
• Fast compilation
• Simple deployment (single binary)
• Great standard library

​

Fiber v3.0.0

• Express-inspired API for Go
• Fastest Go web framework (built on fasthttp)
• Rich middleware ecosystem
• Built-in WebSocket support
• Easy error handling

fiberApp := fiber.New(fiber.Config{
    AppName:         cfg.Server.AppName,
    ErrorHandler:    CustomErrorHandler(log),
    StructValidator: val,
})

• Custom error handler
• CORS middleware (server/server.go:247-254)
• Logger middleware
• Panic recovery
• Request validation

​

Database Layer

​

PostgreSQL

• ACID compliance for data integrity
• JSONB support for flexible activity logs
• Full-text search capabilities
• Robust indexes for performance
• Triggers for automatic timestamp updates

• github.com/jackc/pgx/v5 v5.7.5
• High-performance native Go driver
• Connection pooling
• Prepared statement caching

​

sqlc - Type-Safe SQL

• Generates type-safe Go code from SQL
• Catches SQL errors at compile time
• No runtime reflection
• Full IDE autocomplete support

// From SQL query:
// -- name: GetUserByEmail :one
// SELECT * FROM users WHERE email = $1 LIMIT 1;

// Generated Go method:
func (q *Queries) GetUserByEmail(ctx context.Context, email string) (User, error)

• No ORM overhead
• Write SQL, get Go
• Type-safe parameters and results
• Transaction support via Store pattern

​

golang-migrate

• Version-controlled schema changes
• Up/down migration support
• Embedded migrations in binary
• CLI and programmatic usage

make migrate-up      # Apply all migrations
make migrate-down    # Rollback all migrations
make migrate-create name=<name>  # Create new migration

​

Authentication & Security

​

JWT (JSON Web Tokens)

• Stateless authentication
• Access + Refresh token pattern
• Role-based claims
• Token expiration and validation

type Claims struct {
    UserID   string    `json:"user_id"`
    Username string    `json:"username"`
    Email    string    `json:"email"`
    Role     string    `json:"role"`
    jwt.RegisteredClaims
}

​

bcrypt Password Hashing

• Secure password hashing
• Automatic salt generation
• Configurable cost factor

​

Validation

​

go-playground/validator

• Struct tag-based validation
• Custom validators
• Nested struct validation
• Cross-field validation

type LoginRequest struct {
    Email    string `json:"email" validate:"required,email"`
    Password string `json:"password" validate:"required,min=8"`
}

​

External Integrations

​

Midtrans Payment Gateway

• Credit/Debit Cards (Visa, Mastercard)
• E-wallets (GoPay, OVO, DANA, ShopeePay)
• Bank transfers
• QR codes

• Snap Token generation
• Webhook notifications
• Payment status tracking

​

Cloudflare R2 (S3-Compatible Storage)

• Product images
• Product option images
• User avatars
• App logos

• No egress fees
• S3 API compatibility
• Global CDN distribution
• High availability

​

Logging

​

Logrus

• Structured logging
• Multiple log levels (Debug, Info, Warn, Error, Fatal)
• JSON output for production
• Contextual fields

logger.WithFields(logrus.Fields{
    "user_id": userID,
    "action":  "login",
}).Info("User logged in successfully")

​

API Documentation

​

Swagger/OpenAPI

• Interactive API documentation
• OpenAPI 3.0 specifications
• API client code (for frontend)

// @Summary User login
// @Description Authenticate user and return JWT tokens
// @Tags auth
// @Accept json
// @Produce json
// @Param request body LoginRequest true "Login credentials"
// @Success 200 {object} LoginResponse
// @Router /auth/login [post]

make swag  # Generates Swagger docs and updates frontend API client

​

Utilities

​

UUID Generation

• Unique identifiers for entities
• Version 4 (random) UUIDs
• Database-compatible

​

Environment Variables

• Load .env files
• Development configuration
• Falls back to system env vars in production

​

Testing

​

Go Testing Frameworks

• Assertions: assert.Equal(t, expected, actual)
• Mocking: mock.Mock
• Test suites

• Interface mocking
• Expectation-based testing
• Auto-generated mocks

• Mock PostgreSQL connections
• Test database queries without real DB

func TestGetUserByEmail(t *testing.T) {
    mock, err := pgxmock.NewConn()
    require.NoError(t, err)
    defer mock.Close(ctx)
    
    expected := User{ID: uuid.New(), Email: "[email protected]"}
    mock.ExpectQuery("SELECT").WillReturnRows(
        pgxmock.NewRows([]string{"id", "email"}).AddRow(expected.ID, expected.Email),
    )
    
    repo := repository.New(mock)
    user, err := repo.GetUserByEmail(ctx, "[email protected]")
    
    assert.NoError(t, err)
    assert.Equal(t, expected.Email, user.Email)
}

​

Frontend Stack

​

Runtime & Package Manager

​

Bun

• Fast - 3x faster than Node.js
• Built-in bundler, transpiler, package manager
• Drop-in replacement for Node.js
• Native TypeScript support

{
  "dev": "vite dev",
  "build": "vite build && tsc --noEmit",
  "api:gen": "openapi-generator-cli generate",
  "rbac:gen": "bun run scripts/gen-rbac.ts"
}

​

Framework

​

TanStack Start v1.132.0

• File-based routing
• Server-side rendering (SSR)
• Streaming SSR
• Type-safe routing
• Built on Vite

• @tanstack/react-router v1.132.0 - Advanced routing
• @tanstack/router-plugin v1.132.0 - Vite integration
• @tanstack/react-start v1.132.0 - Full-stack features

​

React 19.2.0

• Improved hydration
• Better error handling
• Enhanced server components
• Optimized rendering

​

State Management

​

TanStack Query v5.90.9

• Automatic caching
• Background refetching
• Request deduplication
• Pagination & infinite scroll
• Optimistic updates

const { data, isLoading } = useQuery({
  queryKey: ['products'],
  queryFn: () => productsApi.getProducts(),
})

​

Form Management

​

React Hook Form v7.66.0

• Minimal re-renders
• Schema-based validation
• TypeScript support
• Easy error handling

​

Zod v4.1.12

const loginSchema = z.object({
  email: z.string().email(),
  password: z.string().min(8),
})

type LoginForm = z.infer<typeof loginSchema>

​

UI Component Libraries

​

Shadcn UI

• Radix UI primitives - Accessible, unstyled components
• Tailwind CSS - Utility-first styling
• Copy-paste components - Full customization

• Accordion, Alert Dialog, Avatar
• Checkbox, Dialog, Dropdown Menu
• Popover, Select, Tabs, Tooltip
• And 20+ more…

​

Tailwind CSS v4.0.6

• Rapid UI development
• Consistent design system
• Optimized production builds
• Dark mode support

​

Styling Utilities

• clsx v2.1.1 - Conditional class names
• tailwind-merge v3.0.2 - Merge Tailwind classes
• class-variance-authority v0.7.1 - Component variants

import { cn } from '@/lib/utils'

const buttonVariants = cva('px-4 py-2 rounded', {
  variants: {
    variant: {
      primary: 'bg-blue-500 text-white',
      secondary: 'bg-gray-200 text-black',
    },
  },
})

​

Internationalization

​

i18next v25.8.0

• Multi-language support (English, Indonesian)
• Lazy loading of translations
• Pluralization
• Date/number formatting

​

API Client

​

Axios v1.13.2

• Promise-based requests
• Interceptors for auth
• Request/response transformation
• Timeout handling

​

OpenAPI Generator

• TypeScript API client
• Type definitions
• Request/response models

make swag  # Updates Swagger and generates frontend API client

​

Additional UI Libraries

• lucide-react v0.553.0 - Icon library
• recharts v2.15.4 - Charts and graphs
• date-fns v4.1.0 - Date utilities
• react-day-picker v9.11.1 - Date picker
• sonner v2.0.7 - Toast notifications
• cmdk v1.1.1 - Command palette
• vaul v1.1.2 - Drawer component
• react-easy-crop v5.5.6 - Image cropping

​

Build Tools

​

Vite v7.1.7

• Lightning-fast HMR
• Optimized production builds
• Native ESM support
• Plugin ecosystem

• @vitejs/plugin-react v5.0.4
• vite-tsconfig-paths v5.1.4

​

TypeScript v5.7.2

• Static type checking
• Enhanced IDE support
• Compile-time error detection

​

Testing (Frontend)

• Vitest v3.0.5 - Vite-native test runner
• @testing-library/react v16.2.0 - Component testing
• jsdom v27.0.0 - DOM simulation

​

Development Tools

​

Code Quality

• Air - Go hot reload
• ESLint - JavaScript/TypeScript linting
• Prettier - Code formatting

​

Container & Deployment

​

Docker

• Consistent development environment
• Easy deployment
• Isolated dependencies

​

Nitro (Latest)

• Deploy anywhere
• Serverless support
• API routes

​

Automation

​

Makefile

make migrate-up       # Run database migrations
make migrate-create   # Create new migration
make sqlc-generate    # Generate sqlc code
make seed             # Seed database
make swag             # Generate API docs
make docker-be        # Start backend container

​

Version Control & CI/CD

​

Git

• Version control
• Branch management
• Collaboration

​

GitHub Actions (Recommended)

• Automated testing
• Deployment pipelines
• Code quality checks

​

Summary

​

Backend Tech Highlights

• Go + Fiber - High-performance API
• sqlc + PostgreSQL - Type-safe database queries
• JWT + RBAC - Secure authentication
• Midtrans + R2 - Payment & storage integrations

​

Frontend Tech Highlights

• TanStack Start - Modern React framework
• TanStack Query - Powerful data fetching
• Shadcn UI + Tailwind - Beautiful, accessible UI
• Auto-generated API Client - Type-safe backend communication

​

Development Experience

• Full type safety across stack
• Hot reload for rapid iteration
• Auto-generated code reduces boilerplate
• Comprehensive testing tools

​

Next Steps

• Architecture - System design and patterns
• Database Schema - Complete schema documentation
• Contributing Guide - Start developing