Moving to github

.github/DEVELOPMENT.md

@@ -0,0 +1,96 @@
+# Development Setup
+
+## Environment Management
+
+This project uses **Nix with direnv** for reproducible development environments.
+
+### What You Get Automatically
+
+When you `cd` into the project directory, direnv automatically provides:
+
+- Ruby 3.3
+- Go Task (task runner)
+- Docker & Docker Compose
+- PostgreSQL 16 client
+- Build tools (gcc, make, pkg-config)
+- Required libraries (libyaml, libffi, openssl, zlib)
+
+### First Time Setup
+
+1. **Install Nix** (if not already installed)
+   ```bash
+   sh <(curl -L https://nixos.org/nix/install) --daemon
+   ```
+
+2. **Install direnv** (if not already installed)
+   ```bash
+   # macOS
+   brew install direnv
+   
+   # Or via Nix
+   nix-env -iA nixpkgs.direnv
+   ```
+
+3. **Configure your shell** (add to `~/.bashrc` or `~/.zshrc`)
+   ```bash
+   eval "$(direnv hook bash)"  # for bash
+   eval "$(direnv hook zsh)"   # for zsh
+   ```
+
+4. **Allow direnv in project**
+   ```bash
+   cd turbovault-web
+   direnv allow
+   ```
+
+That's it! All dependencies are now available.
+
+## Quick Start
+
+```bash
+# Setup everything
+task setup
+
+# Start development
+task server
+
+# See all available commands
+task
+```
+
+## Available Tasks
+
+Run `task` or `task --list` to see all available commands.
+
+Key tasks:
+- `task setup` - Complete initial setup
+- `task server` - Start Rails server
+- `task test` - Run tests
+- `task db:reset` - Reset database
+- `task docker:logs` - View PostgreSQL logs
+
+## Nix Configuration
+
+The `shell.nix` file defines all dependencies. If you need to add more tools:
+
+1. Edit `shell.nix`
+2. Reload: `direnv reload`
+
+## Troubleshooting
+
+### direnv not loading
+```bash
+direnv allow
+```
+
+### Missing dependencies
+```bash
+# Reload Nix shell
+direnv reload
+
+# Or exit and re-enter directory
+cd .. && cd turbovault-web
+```
+
+### Update Nix packages
+Edit the nixpkgs URL in `shell.nix` to a newer version if needed.