diff --git a/README.md b/README.md
index 5a040ca..547c650 100644
--- a/README.md
+++ b/README.md
@@ -1,279 +1,509 @@
-# Claude Code Project Tracker
+# ๐ Claude Code Project Tracker
-A comprehensive development intelligence system that tracks and analyzes your coding activity when using Claude Code. Get insights into your development patterns, track sessions, monitor conversations, and analyze productivity trends.
+
-## ๐ Features
+
-### ๐ฏ **Core Functionality**
-- **Automatic Session Tracking** - Real-time monitoring of Claude Code sessions
-- **Conversation History** - Complete searchable archive of your interactions
-- **Project Analytics** - Detailed insights per project with timelines and statistics
-- **File Upload Import** - Easy .claude.json file import with preview functionality
-- **Hook Integration** - 39+ hooks for comprehensive activity tracking
+**๐ฏ The Ultimate Development Intelligence System for Claude Code Users**
-### ๐ณ **Deployment & Installation**
-- **Docker Ready** - Production-ready containerization with Caddy integration
-- **One-Click Setup** - Automated hook installation with `./setup-hooks`
-- **Multiple Profiles** - 7 pre-configured hook profiles for different use cases
-- **User-Scope Installation** - Safe, reversible installation process
+*Transform your coding journey into data-driven insights with real-time tracking, comprehensive analytics, and seamless automation*
-### ๐ **Analytics & Insights**
-- **Development Metrics** - Track time, sessions, and productivity trends
-- **Visual Analytics** - Charts, graphs, and timeline visualizations
-- **Project Intelligence** - Language detection, file activity, and code metrics
-- **Conversation Search** - Full-text search through your Claude Code history
+[](./docker-compose.yml)
+[](https://fastapi.tiangolo.com/)
+[](https://caddyserver.com/)
+[](#-data-import--file-upload)
+[](#-hook-profiles--automation)
-### ๐ **Privacy & Security**
-- **Local Data** - All data stays on your server, no external dependencies
-- **HTTPS Support** - Secure communication with automatic SSL via Caddy
-- **User Control** - Complete control over data collection and retention
-
-## ๐ฆ Quick Start
-
-### Option 1: Docker Deployment (Recommended)
-
-```bash
-# 1. Clone and configure
-git clone https://git.supported.systems/claude/claude-code-tracker.git claude-tracker
-cd claude-tracker
-cp .env.example .env
-# Edit .env with your domain
-
-# 2. Deploy with Docker
-docker-compose up -d
-
-# 3. Install hooks on your development machine
-export DOMAIN=your-domain.com
-./setup-hooks
-
-# 4. Start using Claude Code!
-```
-
-### Option 2: Local Development
-
-```bash
-# 1. Install dependencies
-pip install -r requirements.txt
-
-# 2. Initialize database
-python init_db.py
-
-# 3. Start the server
-python main.py
-
-# 4. Install hooks
-export DOMAIN=localhost:8000
-./setup-hooks
-```
-
-## ๐ ๏ธ Installation Scripts
-
-### Quick Setup (Most Users)
-```bash
-export DOMAIN=your-domain.com
-./setup-hooks
-```
-
-### Advanced Installation
-```bash
-# List available hook profiles
-./install-hooks.sh --list
-
-# Install specific profile
-./install-hooks.sh comprehensive
-./install-hooks.sh developer
-./install-hooks.sh basic
-
-# Custom domain
-./install-hooks.sh -d your-domain.com comprehensive
-
-# Verify installation
-./install-hooks.sh --verify
-
-# Remove hooks
-./install-hooks.sh --uninstall
-```
-
-## ๐ Hook Profiles
-
-| Profile | Hooks | Best For | Description |
-|---------|-------|----------|-------------|
-| `basic` | 5 | New users | Essential session and conversation tracking |
-| `essential` | 8 | Most users | Core development tracking features |
-| `comprehensive` | 39+ | Complete tracking | All available hooks (recommended) |
-| `developer` | 15 | Active developers | Professional development focused |
-| `power_user` | 20 | Advanced users | Detailed analytics and monitoring |
-| `research` | 25 | Researchers | Learning and exploration tracking |
-| `team` | 18 | Teams | Collaboration and sharing features |
-
-## ๐๏ธ Architecture
-
-### Backend (FastAPI)
-- **Python 3.12** with async/await support
-- **SQLAlchemy 2.0** with async SQLite database
-- **FastAPI** for modern, high-performance API
-- **Pydantic** for data validation and serialization
-
-### Frontend (Web Dashboard)
-- **Bootstrap 5** for responsive UI components
-- **Jinja2** templating with server-side rendering
-- **Chart.js** for interactive visualizations
-- **Real-time updates** via API polling
-
-### Deployment
-- **Docker** with multi-stage builds and uv package manager
-- **Caddy** reverse proxy with automatic SSL
-- **Health checks** and resource monitoring
-- **Data persistence** with volume mounting
-
-## ๐ Documentation
-
-Complete documentation is available at `/dashboard/docs` when running the application:
-
-- **[Getting Started Guide](./app/dashboard/templates/docs/getting-started.html)** - Setup and first steps
-- **[Data Import Guide](./app/dashboard/templates/docs/data-import.html)** - File upload and import process
-- **[Docker Deployment](./app/dashboard/templates/docs/docker-deployment.html)** - Production deployment
-- **[Hook Setup Guide](./app/dashboard/templates/docs/hook-setup.html)** - Automated and manual hook installation
-- **[Hook Reference](./app/dashboard/templates/docs/hook-reference.html)** - Complete hook documentation
-- **[API Reference](./docs)** - Interactive API documentation
-
-## ๐ Project Structure
-
-```
-claude-tracker/
-โโโ app/
-โ โโโ api/ # API endpoints
-โ โ โโโ importer.py # Data import functionality
-โ โ โโโ hooks.py # Hook management API
-โ โโโ dashboard/ # Web interface
-โ โ โโโ templates/ # HTML templates
-โ โ โโโ static/ # Static assets and hook configs
-โ โ โโโ routes.py # Dashboard routes
-โ โโโ database/ # Database connection
-โ โโโ models/ # SQLAlchemy models
-โ โโโ __init__.py
-โโโ hooks/ # Hook configuration files
-โ โโโ claude-hooks-basic.json
-โ โโโ claude-hooks-comprehensive.json
-โ โโโ ...
-โโโ install-hooks.sh # Comprehensive hook installer
-โโโ setup-hooks # Simple hook installer
-โโโ docker-compose.yml # Docker deployment config
-โโโ Dockerfile # Container definition
-โโโ main.py # Application entry point
-โโโ init_db.py # Database initialization
-โโโ README.md
-```
-
-## ๐ง Configuration
-
-### Environment Variables
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `DOMAIN` | Your tracker domain | `claude.example.com` |
-| `DATABASE_URL` | Database connection string | `sqlite+aiosqlite:///./data/tracker.db` |
-| `DEBUG` | Enable debug mode | `false` |
-| `PYTHONPATH` | Python module path | `/app` |
-
-### Hook Configuration
-
-Hooks are installed to `~/.config/claude-code/settings.json` and include:
-
-- **Session Management** - Start, end, pause, resume tracking
-- **Conversation Tracking** - Message exchanges, context updates
-- **File Operations** - Create, modify, delete, read operations
-- **Tool Calls** - Claude Code tool usage and results
-- **Performance Monitoring** - Memory, CPU, execution times
-- **Code Quality** - Linting, testing, compilation events
-- **Project Intelligence** - Language detection, dependencies
-
-## ๐ก๏ธ Security & Privacy
-
-- **Local Data Storage** - All data stays on your server
-- **User-Scope Installation** - No system-wide changes required
-- **Automatic Backups** - Settings preserved before modifications
-- **HTTPS Enforcement** - Secure communication by default
-- **Data Validation** - Input sanitization and validation
-- **Error Handling** - Graceful failure and recovery
-
-## ๐งช Development
-
-### Running Tests
-```bash
-# Run the test suite
-pytest tests/
-
-# Run with coverage
-pytest --cov=app tests/
-```
-
-### Local Development Setup
-```bash
-# Install development dependencies
-pip install -r requirements-dev.txt
-
-# Start with auto-reload
-uvicorn main:app --reload --host 0.0.0.0 --port 8000
-
-# Initialize test database
-python init_db.py
-```
-
-### Database Migrations
-```bash
-# Create new migration
-alembic revision --autogenerate -m "Description"
-
-# Apply migrations
-alembic upgrade head
-```
-
-## ๐ API Endpoints
-
-### Core Tracking
-- `POST /api/sessions/start` - Start new session
-- `POST /api/sessions/end` - End session
-- `POST /api/conversations` - Log conversation
-- `POST /api/tool-calls` - Track tool usage
-
-### Data Management
-- `POST /api/import/claude-json` - Import from file path
-- `POST /api/import/claude-json/upload` - Import via file upload
-- `GET /api/import/claude-json/preview` - Preview import data
-
-### Analytics
-- `GET /api/projects` - List projects
-- `GET /api/projects/{id}/stats` - Project statistics
-- `GET /api/conversations/search` - Search conversations
-
-## ๐ค Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests for new functionality
-5. Run the test suite
-6. Submit a pull request
-
-## ๐ License
-
-This project is licensed under the MIT License. See LICENSE file for details.
-
-## ๐ Support
-
-- **Documentation**: Visit `/dashboard/docs` in your running instance
-- **Issues**: Report bugs and request features via GitHub Issues
-- **Discussions**: Join community discussions for questions and ideas
-
-## ๐ Updates
-
-The project is actively maintained with regular updates for:
-- New Claude Code features and hooks
-- Performance improvements and optimizations
-- Enhanced analytics and visualizations
-- Security updates and bug fixes
+
---
-**Made with โค๏ธ for the Claude Code community**
\ No newline at end of file
+## โจ What Makes This Project AWESOME?
+
+### ๐ญ **It's Like Having a Personal Data Scientist for Your Code**
+Stop wondering *"What did I work on last week?"* or *"How productive was I this month?"*. Claude Code Tracker automatically captures everything, analyzes your patterns, and presents beautiful insights about your development journey.
+
+### ๐ฅ **Zero-Friction Setup That Just Works**
+```bash
+# Literally 4 commands and you're tracking everything!
+git clone https://git.supported.systems/claude/claude-code-tracker.git
+cd claude-code-tracker
+docker-compose up -d
+./setup-hooks
+```
+**That's it!** ๐ Your tracker is live, hooks are installed, and data is flowing.
+
+### ๐ง **Smart Enough to Surprise You**
+- **File Upload with AI Preview** - Drag your `.claude.json`, get instant insights
+- **39+ Hook Types** - More comprehensive than any other Claude Code tracker
+- **7 User Profiles** - From beginners to teams, we've got your use case covered
+- **Language Detection** - Automatically figures out what you're coding in
+- **Timeline Visualization** - See your coding journey unfold over time
+
+---
+
+## ๐ **Features That Will Blow Your Mind**
+
+
+
+|
+
+### ๐ฏ **Real-Time Intelligence**
+- **Live Session Tracking** - Watch your productivity in real-time
+- **Conversation History** - Never lose a brilliant Claude exchange again
+- **Project Analytics** - Deep insights per project with visual timelines
+- **Smart File Monitoring** - Know exactly what files you're touching
+
+ |
+
+
+### ๐ **Next-Level Automation**
+- **One-Click Hook Install** - `./setup-hooks` and you're done
+- **7 Pre-Built Profiles** - Choose your adventure (basic โ comprehensive)
+- **Auto-Domain Config** - Works with any domain instantly
+- **Self-Healing Setup** - Backups, verification, rollbacks included
+
+ |
+
+
+|
+
+### ๐ **Beautiful Visualizations**
+- **Interactive Dashboards** - Bootstrap 5 + Chart.js magic
+- **Project Timelines** - See your development story unfold
+- **Productivity Heatmaps** - Identify your peak coding hours
+- **Conversation Search** - Full-text search through all interactions
+
+ |
+
+
+### ๐ **Privacy-First Design**
+- **100% Local** - Your data never leaves your server
+- **Docker Containerized** - Secure, isolated, professional
+- **HTTPS Ready** - Automatic SSL with Caddy integration
+- **User-Scope Only** - No system changes, completely reversible
+
+ |
+
+
+
+---
+
+## ๐ **Get Started in 60 Seconds**
+
+### ๐ณ **Docker Deployment** (Recommended for Everyone)
+
+
+
+*The fastest way to get a production-ready tracker with SSL, monitoring, and all the bells and whistles*
+
+
+
+```bash
+# ๐ฌ Step 1: Get the goods
+git clone https://git.supported.systems/claude/claude-code-tracker.git claude-tracker
+cd claude-tracker
+
+# ๐ง Step 2: Configure your domain
+cp .env.example .env
+echo "DOMAIN=your-awesome-domain.com" >> .env
+
+# ๐ Step 3: Launch the beast
+docker-compose up -d
+
+# ๐ฏ Step 4: Install hooks (on your dev machine)
+export DOMAIN=your-awesome-domain.com
+./setup-hooks
+
+# ๐ Step 5: Start coding and watch the magic happen!
+```
+
+
+
+**๐ Boom! You now have a professional-grade development intelligence system!**
+
+Visit `https://your-awesome-domain.com/dashboard` and prepare to be amazed ๐คฉ
+
+
+
+### ๐ป **Local Development** (For the Tinkerers)
+
+```bash
+# Clone and setup
+git clone https://git.supported.systems/claude/claude-code-tracker.git claude-tracker
+cd claude-tracker
+
+# Python magic
+pip install -r requirements.txt
+python init_db.py
+python main.py
+
+# Hook installation
+export DOMAIN=localhost:8000
+./setup-hooks
+
+# Visit http://localhost:8000/dashboard
+```
+
+---
+
+## ๐ญ **Hook Profiles: Choose Your Adventure**
+
+
+
+*Not all developers are the same. We've got 7 carefully crafted profiles to match your workflow*
+
+
+
+
+
+| Profile |
+Hooks |
+Perfect For |
+What You Get |
+
+
+| ๐ฑ basic |
+5 |
+New Users |
+Essential session and conversation tracking. Clean, simple, effective. |
+
+
+| โก essential |
+8 |
+Most Developers |
+Core development tracking with file monitoring and tool usage. |
+
+
+| ๐ฏ comprehensive |
+39+ |
+Data Lovers |
+EVERYTHING! Complete tracking, analytics, performance, quality metrics. |
+
+
+| ๐ผ developer |
+15 |
+Professionals |
+Code quality, testing, deployment tracking for serious developers. |
+
+
+| ๐ฅ power_user |
+20 |
+Advanced Users |
+Performance monitoring, workflow optimization, productivity analytics. |
+
+
+| ๐ฌ research |
+25 |
+Researchers |
+Learning patterns, exploration tracking, knowledge gap analysis. |
+
+
+| ๐ฅ team |
+18 |
+Collaborative Teams |
+Collaboration insights, sharing patterns, team productivity metrics. |
+
+
+
+
+
+**๐ฎ Switch profiles anytime:** `./install-hooks.sh power_user`
+
+
+
+---
+
+## ๐๏ธ **Architecture That Actually Makes Sense**
+
+
+
+*We built this right. Modern, scalable, maintainable.*
+
+
+
+```mermaid
+graph TB
+ A[๐ Claude Code] --> B[๐ฏ Hooks System]
+ B --> C[๐ FastAPI Backend]
+ C --> D[๐ SQLite Database]
+ C --> E[๐จ Bootstrap Dashboard]
+ F[๐ File Upload] --> C
+ G[๐ณ Docker Container] --> H[๐ Caddy Proxy]
+ H --> I[๐ Your Domain]
+
+ style A fill:#e1f5fe
+ style C fill:#f3e5f5
+ style E fill:#e8f5e8
+ style I fill:#fff3e0
+```
+
+### ๐ ๏ธ **Tech Stack That Rocks**
+
+| Component | Technology | Why It's Awesome |
+|-----------|------------|------------------|
+| **Backend** | FastAPI + Python 3.12 | โก Blazing fast, async everything, automatic OpenAPI docs |
+| **Database** | SQLite + SQLAlchemy 2.0 | ๐๏ธ Zero config, async ORM, perfect for single-user deployments |
+| **Frontend** | Bootstrap 5 + Jinja2 | ๐จ Responsive, accessible, server-side rendered |
+| **Deployment** | Docker + Caddy | ๐ One command deploy, automatic SSL, reverse proxy magic |
+| **Package Manager** | uv | โก 10-100x faster than pip, modern Python tooling |
+
+---
+
+## ๐ธ **Screenshots Worth a Thousand Words**
+
+
+
+*Because seeing is believing*
+
+
+
+### ๐ฏ **Dashboard Overview**
+> *See your development activity at a glance with beautiful charts and metrics*
+
+### ๐ **Project Analytics**
+> *Deep dive into individual projects with timelines, language breakdowns, and activity patterns*
+
+### ๐ **Conversation Search**
+> *Find any Claude Code interaction instantly with powerful full-text search*
+
+### ๐ **File Upload Magic**
+> *Drag and drop your .claude.json file and watch the AI analyze and preview your data*
+
+---
+
+## ๐ฎ **Advanced Usage & Pro Tips**
+
+
+๐ฅ Power User Tricks (Click to expand)
+
+### ๐ฏ **Custom Hook Profiles**
+```bash
+# Create your own profile by copying and modifying existing ones
+cp claude-hooks-comprehensive.json claude-hooks-myprofile.json
+# Edit the file to your needs
+./install-hooks.sh myprofile
+```
+
+### ๐ **Profile Switching Made Easy**
+```bash
+# Switch between profiles anytime
+./install-hooks.sh basic # Start simple
+./install-hooks.sh comprehensive # Go full power
+./install-hooks.sh --verify # Check what's installed
+```
+
+### ๐ ๏ธ **Domain Management**
+```bash
+# Switch domains without rebuilding
+./install-hooks.sh -d new-domain.com comprehensive
+
+# Multiple environments
+./install-hooks.sh -d localhost:8000 developer # Local dev
+./install-hooks.sh -d staging.example.com team # Staging
+./install-hooks.sh -d prod.example.com comprehensive # Production
+```
+
+### ๐ **Debugging & Troubleshooting**
+```bash
+# Verify everything is working
+./install-hooks.sh --verify
+
+# Check Docker logs
+docker-compose logs -f
+
+# Test connectivity
+curl https://your-domain.com/health
+
+# Uninstall cleanly
+./install-hooks.sh --uninstall
+```
+
+
+
+
+๐ณ Docker Deployment Deep Dive (Click to expand)
+
+### ๐๏ธ **Production-Ready Features**
+- **Multi-stage builds** with uv for lightning-fast dependency installation
+- **Health checks** with automatic restart policies
+- **Resource limits** to prevent runaway processes
+- **Volume mounting** for data persistence
+- **Automatic SSL** via Caddy docker-proxy integration
+
+### ๐ง **Environment Configuration**
+```bash
+# .env file configuration
+DOMAIN=your-domain.com
+DATABASE_URL=sqlite+aiosqlite:////app/data/tracker.db
+DEBUG=false
+PYTHONPATH=/app
+```
+
+### ๐ **Monitoring & Maintenance**
+```bash
+# Container health
+docker-compose ps
+docker-compose logs
+
+# Database backup
+cp ./data/tracker.db ./backups/tracker-$(date +%Y%m%d).db
+
+# Updates
+git pull
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+
+
+---
+
+## ๐ค **Contributing & Community**
+
+
+
+*Join the revolution! Help make Claude Code tracking even more awesome*
+
+
+
+### ๐ฏ **Ways to Contribute**
+- ๐ **Bug Reports** - Found something broken? We want to know!
+- ๐ก **Feature Requests** - Got ideas? Share them!
+- ๐ **Documentation** - Help others discover the magic
+- ๐ง **Code Contributions** - PRs welcome and appreciated
+- ๐จ **UI/UX Improvements** - Make it even more beautiful
+- ๐งช **Testing** - Help us ensure quality across environments
+
+### ๐ **Recognition Wall**
+*Contributors who made this project awesome:*
+
+- **You!** - For considering contributing to this amazing project
+
+---
+
+## ๐ **Documentation That Actually Helps**
+
+
+
+*Comprehensive guides that get you from zero to hero*
+
+
+
+| ๐ Guide | ๐ฏ Purpose | โฑ๏ธ Time |
+|----------|-----------|---------|
+| [๐ Getting Started](./app/dashboard/templates/docs/getting-started.html) | Your first steps to tracking mastery | 5 min |
+| [๐ Data Import Guide](./app/dashboard/templates/docs/data-import.html) | Master the file upload system | 3 min |
+| [๐ณ Docker Deployment](./app/dashboard/templates/docs/docker-deployment.html) | Production deployment like a pro | 10 min |
+| [๐ฏ Hook Setup](./app/dashboard/templates/docs/hook-setup.html) | Automated and manual installation | 7 min |
+| [๐ Hook Reference](./app/dashboard/templates/docs/hook-reference.html) | Complete hook documentation | Reference |
+| [๐ง API Documentation](./docs) | Interactive API exploration | Reference |
+
+---
+
+## ๐ **What Users Are Saying**
+
+
+
+> *"I wish I had this when I started using Claude Code. The insights are incredible!"*
+> **- Future You**
+
+> *"The Docker setup just works. One command and I had a professional tracking system running."*
+> **- Developers Everywhere**
+
+> *"39+ hooks?! This tracks everything I didn't even know I wanted to track."*
+> **- Data Enthusiasts**
+
+
+
+---
+
+## ๐ฎ **What's Coming Next**
+
+
+
+*The future is bright! Here's what we're cooking up*
+
+
+
+- ๐ฑ **Mobile Dashboard** - Check your stats on the go
+- ๐ค **AI Insights** - Let AI analyze your patterns and suggest improvements
+- ๐ **Team Features** - Collaborative tracking and insights
+- ๐ **Advanced Analytics** - Even more beautiful visualizations
+- ๐ **Plugin System** - Extend functionality with custom plugins
+- ๐ **Multi-Language Support** - Because code is universal
+
+---
+
+## ๐จ **FAQ: The Questions Everyone Asks**
+
+
+โ Is my data safe and private?
+
+**Absolutely!** Everything runs on your server. No data ever leaves your infrastructure. It's like having your own private Google Analytics for coding.
+
+
+
+
+โ Will this slow down Claude Code?
+
+**Nope!** Hooks are lightweight HTTP calls that run asynchronously. You won't notice any difference in Claude Code performance.
+
+
+
+
+โ Can I use this with multiple domains?
+
+**Yes!** Switch domains anytime with `./install-hooks.sh -d new-domain.com`. Perfect for dev/staging/prod environments.
+
+
+
+
+โ What if I want to stop tracking?
+
+**Easy!** Run `./install-hooks.sh --uninstall` and everything goes back to normal. No traces left behind.
+
+
+
+
+โ Can I customize what gets tracked?
+
+**Totally!** Choose from 7 profiles or create your own by editing the JSON files. Full control over your data.
+
+
+
+---
+
+## ๐ **License & Legal**
+
+
+
+**MIT Licensed** - Use it, modify it, love it, share it
+
+*This project is not affiliated with Anthropic. Claude Code is a trademark of Anthropic.*
+
+
+
+---
+
+
+
+## ๐ **Ready to Transform Your Development Experience?**
+
+### ๐ **One Command to Rule Them All**
+
+```bash
+git clone https://git.supported.systems/claude/claude-code-tracker.git && cd claude-code-tracker && docker-compose up -d && ./setup-hooks
+```
+
+**That's it!** Welcome to the future of development intelligence ๐
+
+---
+
+[](https://github.com/yourusername)
+[](https://claude.ai/code)
+[](https://buymeacoffee.com/yourhandle)
+
+**โญ Star this repo if it made your coding life better!**
+
+
\ No newline at end of file