Add Docker, Nix, and devcontainer configurations with setup documentation

Co-authored-by: npv2k1 <[email protected]>

Author: Copilot

.devcontainer/devcontainer.json

@@ -0,0 +1,52 @@
+{
+  "name": "Template Rust Development",
+  "image": "mcr.microsoft.com/devcontainers/rust:1-bookworm",
+  
+  "features": {
+    "ghcr.io/devcontainers/features/rust:1": {
+      "version": "latest",
+      "profile": "default"
+    },
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "rust-lang.rust-analyzer",
+        "vadimcn.vscode-lldb",
+        "serayuzgur.crates",
+        "tamasfe.even-better-toml",
+        "usernamehw.errorlens",
+        "ms-vscode.makefile-tools"
+      ],
+      "settings": {
+        "rust-analyzer.checkOnSave.command": "clippy",
+        "rust-analyzer.cargo.features": "all",
+        "editor.formatOnSave": true,
+        "editor.defaultFormatter": "rust-lang.rust-analyzer",
+        "[rust]": {
+          "editor.defaultFormatter": "rust-lang.rust-analyzer"
+        }
+      }
+    }
+  },
+
+  "postCreateCommand": "cargo build",
+
+  "remoteEnv": {
+    "RUST_BACKTRACE": "1",
+    "DATABASE_URL": "todo.db"
+  },
+
+  "mounts": [
+    "source=${localWorkspaceFolder}/data,target=/workspaces/${localWorkspaceFolderBasename}/data,type=bind,consistency=cached"
+  ],
+
+  "forwardPorts": [],
+
+  "portsAttributes": {},
+
+  "remoteUser": "vscode"
+}

.dockerignore

@@ -0,0 +1,35 @@
+# Build artifacts
+target/
+*.db
+*.db-*
+
+# Git
+.git/
+.gitignore
+
+# IDE
+.vscode/
+.idea/
+
+# CI/CD
+.github/
+
+# Documentation
+*.md
+docs/
+
+# Nix
+*.nix
+.envrc
+
+# Devcontainer
+.devcontainer/
+
+# Docker
+Dockerfile
+docker-compose.yml
+.dockerignore
+
+# Misc
+.env
+.env.*

Dockerfile

@@ -0,0 +1,58 @@
+# Multi-stage build for minimal final image
+FROM rust:1.75-slim as builder
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y \
+    pkg-config \
+    libssl-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create a new empty project
+WORKDIR /app
+
+# Copy manifests
+COPY Cargo.toml Cargo.lock ./
+
+# Copy source code
+COPY src ./src
+COPY examples ./examples
+COPY tests ./tests
+
+# Build the application in release mode
+RUN cargo build --release
+
+# Runtime stage
+FROM debian:bookworm-slim
+
+# Install runtime dependencies
+RUN apt-get update && apt-get install -y \
+    ca-certificates \
+    libssl3 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create a non-root user
+RUN useradd -m -u 1000 appuser
+
+WORKDIR /app
+
+# Copy the binary from builder
+COPY --from=builder /app/target/release/template-rust /usr/local/bin/template-rust
+
+# Change ownership
+RUN chown -R appuser:appuser /app
+
+# Switch to non-root user
+USER appuser
+
+# Set default database path
+ENV DATABASE_URL=/app/data/todo.db
+
+# Create data directory
+RUN mkdir -p /app/data
+
+# Expose any necessary ports (if needed for future web features)
+# EXPOSE 8080
+
+# Set the default command
+ENTRYPOINT ["template-rust"]
+CMD ["--help"]

README.md

@@ -11,9 +11,14 @@ A Rust project template featuring a todo application with SQLite database and te
 - 🚀 CI/CD with GitHub Actions
 - 📦 Cross-platform releases
 - 🔒 Security auditing
+- 🐳 Docker and Docker Compose support
+- ❄️ Nix flakes for reproducible environments
+- 📦 Devcontainer configuration for GitHub Codespaces
 
 ## Installation
 
+> **💡 Quick Start**: See [SETUP.md](SETUP.md) for detailed setup instructions using Docker, Nix, Codespaces, or local development.
+
 ### From Source
 
 ```bash
@@ -26,6 +31,33 @@ cargo build --release
 
 Download the latest binary from the [Releases](https://github.com/pnstack/template-rust/releases) page.
 
+### With Docker
+
+```bash
+# Build the image
+docker build -t template-rust:latest .
+
+# Run with interactive TUI
+docker run --rm -it -v $(pwd)/data:/app/data template-rust:latest tui
+
+# Or use Docker Compose
+docker compose up
+```
+
+### With Nix
+
+```bash
+# Enter development environment
+nix develop
+
+# Or run directly
+nix run
+```
+
+### With GitHub Codespaces
+
+Click the "Code" button on GitHub and select "Create codespace on main" - everything is pre-configured!
+
 ## Usage
 
 ### Command Line Interface
@@ -93,15 +125,28 @@ template-rust/
 
 ## Development
 
+> **📚 Full Setup Guide**: See [SETUP.md](SETUP.md) for comprehensive development environment setup instructions.
+
 ### Prerequisites
 
-- Rust 1.70 or later
-- SQLite3
+Choose your preferred development method:
+
+- **Local**: Rust 1.70 or later, SQLite3
+- **Docker**: Docker 20.10+ and Docker Compose
+- **Nix**: Nix package manager with flakes enabled
+- **Codespaces**: Just a GitHub account!
 
 ### Building
 
 ```bash
+# Local
 cargo build
+
+# Docker
+docker compose up --build
+
+# Nix
+nix build
 ```
 
 ### Running Tests
@@ -122,6 +167,15 @@ cargo clippy -- -D warnings
 cargo fmt
 ```
 
+### Development Environments
+
+The project provides multiple development environment options:
+
+- **Docker Compose**: `docker compose up dev` - Containerized development with live code mounting
+- **Nix Flakes**: `nix develop` - Reproducible environment with all dependencies
+- **Devcontainer**: Open in VS Code or GitHub Codespaces - Fully configured IDE
+- **Traditional**: Local Rust installation with cargo
+
 ## Database
 
 The application uses SQLite for persistence. By default, it creates a `todo.db` file in the current directory. You can specify a different database path: