first commit

Author: aryasatya13

.env.example

@@ -0,0 +1,22 @@
+# ---- Database ----
+DATABASE_URL=postgres://waitless:waitless123@localhost:5432/waitless?sslmode=disable
+
+# Set to "true" to enable SQL query logging
+DB_DEBUG=false
+
+# ---- Server ----
+PORT=8070
+
+# ---- Security ----
+# Used for AES-256 encryption of SMTP passwords + session signing (min 32 chars)
+SESSION_SECRET=waitless-dev-key-change-me-32!!
+
+# Set to "true" in production for Secure cookie flag
+COOKIE_SECURE=false
+
+# Comma-separated allowed origins (default: * in dev)
+# ALLOWED_ORIGINS=https://yourdomain.com
+
+# ---- Logging ----
+# LOG_LEVEL=debug
+# LOG_FORMAT=json (auto in production via GO_ENV=production)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,19 @@
+---
+name: Bug Report
+about: Report a bug
+---
+
+**Describe the bug**
+A clear description of what happened.
+
+**To Reproduce**
+Steps to reproduce the behavior.
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- OS:
+- Go version:
+- Bun version:
+- Browser:

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  backend:
+    name: Go Backend
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.25'
+          cache-dependency-path: backend/go.sum
+      - name: Build
+        run: cd backend && go build ./...
+      - name: Test
+        run: cd backend && go test ./...
+      - name: Vet
+        run: cd backend && go vet ./...
+
+  frontend:
+    name: Frontend
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+      - name: Install
+        run: cd frontend && bun install --frozen-lockfile
+      - name: Build
+        run: cd frontend && bun run build
+      - name: Test
+        run: cd frontend && bun run test

.gitignore

@@ -0,0 +1,31 @@
+# Binaries
+waitless
+*.exe
+
+# Dependencies
+frontend/node_modules/
+frontend/dist/
+backend/cmd/server/dist/
+
+# Environment
+.env
+.env.local
+.env.production
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Build
+/dist/
+/tmp/

CONTRIBUTING.md

@@ -0,0 +1,83 @@
+# Contributing to Waitless
+
+Thanks for your interest in contributing! Here's how to get started.
+
+## Development Setup
+
+### Prerequisites
+- Go 1.25+
+- Bun 1.2+
+- PostgreSQL 16+
+
+### Quick Start
+
+```bash
+git clone https://github.com/waitless/waitless
+cd waitless
+
+# Configure
+cp .env.example .env
+# Edit .env with your local database credentials
+
+# Backend
+cd backend && go mod download
+
+# Frontend
+cd ../frontend && bun install
+
+# Run both dev servers
+make dev-backend  # Terminal 1
+make dev-frontend # Terminal 2
+```
+
+## Project Structure
+
+```
+waitless/
+├── backend/           # Go API server
+│   ├── cmd/server/    # Main entrypoint
+│   └── internal/      # Business logic
+│       ├── api/       # HTTP handlers
+│       ├── database/  # Database connection
+│       ├── middleware/ # Auth, security, rate limiting
+│       ├── models/    # GORM data models
+│       └── services/  # Email, crypto, validation
+├── frontend/          # TanStack Start + React
+│   └── src/
+│       ├── routes/    # File-based routing
+│       └── lib/       # API client, utilities
+└── docker/            # Dockerfile + compose
+```
+
+## Making Changes
+
+1. **Fork the repo** and create a branch from `main`
+2. **Write your code** — follow existing patterns
+3. **Test your changes** — `make test`
+4. **Submit a PR** — describe what you changed and why
+
+## Code Style
+
+- **Go**: `gofmt` + `go vet`
+- **TypeScript**: Standard TypeScript, no semicolons in JSX
+- **CSS**: Vanilla CSS with design tokens
+
+## What to Contribute
+
+- 🐛 Bug fixes
+- 📖 Documentation improvements
+- 🌐 Translations
+- 🧩 New integrations
+- ✅ Tests
+- 🎨 UI improvements
+
+## Reporting Issues
+
+Use GitHub Issues. Include:
+- Steps to reproduce
+- Expected vs actual behavior
+- Environment details (Go version, OS, browser)
+
+## License
+
+By contributing, you agree your contributions will be licensed under the MIT License.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Waitless Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,51 @@
+.PHONY: dev dev-backend dev-frontend build run kill clean install test
+
+# Production — kill, clean build, run single binary
+run: kill clean build
+	@nohup ./waitless > /tmp/waitless.log 2>&1 & echo "✅ Waitless running (PID $$!)"
+	@sleep 1
+	@tail -5 /tmp/waitless.log
+
+# Build production binary
+build:
+	@echo "Building frontend..."
+	@cd frontend && bun run build
+	@echo "Copying dist to backend embed..."
+	@rm -rf backend/cmd/server/dist
+	@cp -r frontend/dist backend/cmd/server/dist
+	@echo "Building Go binary..."
+	@cd backend && CGO_ENABLED=0 go build -ldflags="-s -w" -o ../waitless ./cmd/server
+	@echo "✅ Built: ./waitless"
+
+# Development — runs both backend + frontend
+dev:
+	@echo "Starting Waitless dev mode..."
+	@make -j2 dev-backend dev-frontend
+
+dev-backend:
+	cd backend && go run ./cmd/server
+
+dev-frontend:
+	cd frontend && bun run dev
+
+# Kill any running waitless server
+kill:
+	@-lsof -ti:8070 | xargs kill -9 2>/dev/null || true
+	@sleep 0.5
+
+# Clean
+clean:
+	@rm -rf waitless frontend/dist backend/cmd/server/dist
+
+# Logs
+logs:
+	@tail -f /tmp/waitless.log
+
+# Install dependencies
+install:
+	cd frontend && bun install
+	cd backend && go mod download
+
+# Run tests
+test:
+	cd backend && go test ./...