CT Go Web Starter

A modern Go web application starter template with HTMX, Alpine.js, and TailwindCSS.

Features

• Go - Clean, fast backend with structured routing
• HTMX - Dynamic frontend interactions without JavaScript complexity
• Alpine.js - Lightweight JavaScript framework for reactivity
• TailwindCSS - Utility-first CSS framework
• Live Reload - Air integration for development hot reloading
• Static Asset Caching - Built-in ETag support for efficient caching
• Feature-Based Architecture - Organized by features (vertical slices) for better maintainability

Quick Start

Prerequisites

• Go 1.24.2 or later
• Node.js (for TailwindCSS and frontend dependencies)

Installation

1. Clone the repository:

   git clone <your-repo-url>
   cd ct-go-web-starter

2. Install dependencies:

   npm install
   go mod tidy

3. Build CSS and assets:

   go generate

4. Run the development server:

   air

The application will be available at http://localhost:8080

Development

Project Structure

├── src/
│   ├── features/           # Feature-based organization (vertical slices)
│   │   └── home/          # Home page feature
│   │       ├── handler.go # HTTP handler for home routes
│   │       └── home.html  # Feature-specific template
│   ├── shared/            # Shared components and utilities
│   │   ├── components/    # Reusable UI components
│   │   │   ├── header/    # Header component
│   │   │   └── footer/    # Footer component
│   │   ├── templates/     # Base page templates
│   │   └── utils/         # Common utility functions
│   ├── infrastructure/    # Cross-cutting infrastructure concerns
│   │   ├── config/        # Configuration and logging
│   │   └── fileserver/    # Static file serving with caching
│   ├── static/           # Static assets (favicon, images, etc.)
│   ├── styles/           # TailwindCSS source files
│   └── app.go           # Application setup and routing
├── scripts/             # Build scripts
├── build/              # Generated assets (not in git)
├── .air.toml          # Live reload configuration
└── package.json       # Frontend dependencies

Available Commands

• air - Start development server with live reload
• go run main.go - Run without live reload
• go generate - Build CSS and copy assets
• npm run build-css - Build TailwindCSS only

Adding New Features

1. Create a new feature directory in src/features/
2. Add handler.go and feature-specific templates
3. Register routes in src/app.go
4. Use shared components from src/shared/components/

Example: Adding a "blog" feature

src/features/blog/
├── handler.go          # Blog route handlers
├── list.html          # Blog post listing template
├── detail.html        # Individual blog post template
└── components/         # Blog-specific components
    └── post-card.html

Styling

TailwindCSS classes are available throughout the application. Modify src/styles/styles.css to add custom styles or extend the configuration in src/styles/config.css.

Production

Build the application for production:

go generate
go build -o app main.go
./app

License

This project is open source and available under the MIT License.