Game

Author: Jonovono

game/.air.toml

@@ -0,0 +1,37 @@
+root = "."
+tmp_dir = "tmp"
+
+[build]
+  bin = "./tmp/main"
+  cmd = "templ generate && go build -o ./tmp/main ."
+  delay = 1000
+  exclude_dir = ["assets", "tmp", "vendor"]
+  exclude_file = []
+  exclude_regex = [".*_templ.go"]
+  exclude_unchanged = false
+  follow_symlink = false
+  full_bin = ""
+  include_dir = []
+  include_ext = ["go", "tpl", "tmpl", "templ", "html"]
+  kill_delay = "0s"
+  log = "build-errors.log"
+  send_interrupt = false
+  stop_on_error = true
+
+[color]
+  app = ""
+  build = "yellow"
+  main = "magenta"
+  runner = "green"
+  watcher = "cyan"
+
+[log]
+  time = false
+
+[misc]
+  clean_on_exit = false
+
+[proxy]
+  enabled = true
+  proxy_port = 7331
+  app_port = 3000 

game/.templui.json

@@ -0,0 +1,6 @@
+{
+  "componentsDir": "ui/components",
+  "utilsDir": "utils",
+  "moduleName": "server",
+  "jsDir": "assets/js"
+}

game/Dockerfile

@@ -0,0 +1,14 @@
+ARG GO_VERSION=1
+FROM golang:${GO_VERSION}-bookworm as builder
+
+WORKDIR /usr/src/app
+COPY go.mod go.sum ./
+RUN go mod download && go mod verify
+COPY . .
+RUN go build -v -o /run-app .
+
+
+FROM debian:bookworm
+
+COPY --from=builder /run-app /usr/local/bin/
+CMD ["run-app"]

game/Makefile

@@ -0,0 +1,71 @@
+.PHONY: setup install-tools deps templ-generate build run dev clean templ server tailwind-clean tailwind-watch
+
+setup: install-tools deps templ-generate
+	@echo "✅ Setup complete!"
+
+install-tools:
+	@echo "📦 Installing development tools..."
+	@go install github.com/a-h/templ/cmd/templ@latest
+	@go install github.com/air-verse/air@latest
+
+deps:
+	@echo "📦 Installing dependencies..."
+	@go mod tidy
+	@go mod download
+
+templ-generate:
+	@echo "🎨 Generating templ files..."
+	@templ generate
+
+build: templ-generate tailwind-clean
+	@echo "🏗️  Building application..."
+	@go build -o bin/server .
+
+run: templ-generate
+	@echo "🚀 Running application..."
+	@go run .
+
+# Run templ generation in watch mode to detect all .templ files and 
+# re-create _templ.txt files on change, then send reload event to browser. 
+# Default url: http://localhost:7331
+templ:
+	templ generate --watch --proxy="http://localhost:3000" --open-browser=false
+
+# Run air to detect any go file changes to re-build and re-run the server.
+server:
+	air \
+	--build.cmd "go build -o tmp/bin/main ./server.go" \
+	--build.bin "tmp/bin/main" \
+	--build.delay "100" \
+	--build.exclude_dir "node_modules" \
+	--build.include_ext "go" \
+	--build.stop_on_error "false" \
+	--misc.clean_on_exit true
+
+tailwind-clean:
+	tailwindcss -i ./assets/css/input.css -o ./assets/css/output.css --clean
+
+# Run tailwindcss to generate the styles.css bundle in watch mode.
+tailwind-watch:
+	tailwindcss -i ./assets/css/input.css -o ./assets/css/output.css --watch
+
+# Start development server
+dev:
+	make tailwind-clean
+	make -j3 tailwind-watch templ server
+
+dev-templ:
+	@echo "🔥 Starting development with templ watch + proxy..."
+	@echo "🌐 Server will be available at http://localhost:3000"
+	@echo "🔄 Hot reload proxy at http://localhost:7331"
+	@templ generate --watch --proxy="http://localhost:3000" --cmd="go run ."
+
+clean:
+	@echo "🧹 Cleaning up..."
+	@rm -rf tmp/
+	@rm -rf bin/
+	@rm -f *_templ.go
+	@rm -f assets/css/output.css 
+
+start-baml:
+	npx @boundaryml/baml dev

game/README.md

@@ -0,0 +1,176 @@
+# AI Chat Bot - Datastar + Templ + Chi
+
+A real-time chat bot application built with:
+- **Go Chi** - Lightweight HTTP router
+- **Templ** - Type-safe HTML templating
+- **Datastar** - Real-time reactivity
+- **Hot Reloading** - Development experience
+
+## Features
+
+- 🤖 AI-powered chat responses
+- ⚡ Real-time streaming responses
+- 🎨 Beautiful, modern UI
+- 🔄 Hot reloading for development
+- 📱 Responsive design
+- ✨ Smooth typing animations
+
+## Quick Start
+
+### Prerequisites
+
+- Go 1.24.3 or higher
+- Make (optional, for convenience commands)
+
+### Setup
+
+1. **Install dependencies and tools:**
+   ```bash
+   make setup
+   ```
+
+2. **Start development server with hot reloading:**
+   ```bash
+   make dev
+   ```
+
+3. **Open your browser:**
+   - Main app: http://localhost:3000
+   - Hot reload proxy: http://localhost:7331
+
+### Alternative Development Options
+
+**Option 1: Using Air (recommended)**
+```bash
+make dev
+```
+
+**Option 2: Using Templ's built-in watch**
+```bash
+make dev-templ
+```
+
+**Option 3: Manual run**
+```bash
+make run
+```
+
+## Development Commands
+
+```bash
+# One-time setup
+make setup
+
+# Start development with hot reload
+make dev
+
+# Generate templ files only
+make templ-generate
+
+# Build the application
+make build
+
+# Run without hot reload
+make run
+
+# Clean generated files
+make clean
+```
+
+## How It Works
+
+### Hot Reloading
+
+The application supports two hot reloading approaches:
+
+1. **Air** - Monitors file changes and rebuilds/restarts the server
+2. **Templ Watch** - Built-in templ file watching with proxy
+
+Both approaches provide:
+- Automatic template regeneration when `.templ` files change
+- Server restart when `.go` files change
+- Browser auto-refresh via proxy
+
+### File Structure
+
+```
+apps/server/
+├── server.go          # Main Chi server
+├── templates.templ    # Templ templates
+├── .air.toml         # Air configuration
+├── Makefile          # Development commands
+├── go.mod            # Go dependencies
+└── README.md         # This file
+```
+
+### Architecture
+
+- **Chi** handles HTTP routing and middleware
+- **Templ** generates type-safe HTML templates
+- **Datastar** provides real-time reactivity via SSE
+- **Hot reload** proxy injects auto-refresh JavaScript
+
+## Chat Features
+
+The chat bot includes:
+
+- Keyword-based responses (hello, help, weather, etc.)
+- Streaming word-by-word responses
+- Typing indicators
+- Message history
+- Responsive design
+
+## Customization
+
+### Adding New Bot Responses
+
+Edit the `generateResponse` function in `server.go`:
+
+```go
+responses := map[string]string{
+    "your_keyword": "Your custom response",
+    // ... existing responses
+}
+```
+
+### Styling
+
+Modify the CSS in `templates.templ` within the `<style>` block.
+
+### Templates
+
+Add new templ components in `templates.templ` or create new `.templ` files.
+
+## Production Build
+
+```bash
+make build
+./bin/server
+```
+
+## Troubleshooting
+
+### Port Already in Use
+If port 3000 is busy, change it in `server.go`:
+```go
+log.Fatal(http.ListenAndServe(":8080", router)) // Change to your preferred port
+```
+
+### Templ Generation Issues
+```bash
+make clean
+make templ-generate
+```
+
+### Dependencies Issues
+```bash
+go mod tidy
+make deps
+```
+
+## Learn More
+
+- [Chi Documentation](https://go-chi.io/)
+- [Templ Documentation](https://templ.guide/)
+- [Datastar Documentation](https://data-star.dev/)
+- [Air Documentation](https://github.com/air-verse/air)