thrillwiki_django_no_react/cline_docs/techContext.md

# Technical Context

## Core Technologies

### Backend Framework
1. Django
   - MVT architecture
   - ORM for data management
   - Template system
   - URL routing
   - Form handling
   - Authentication
   - Admin interface

2. Python
   - Version requirements
   - Core libraries
   - Package management
   - Virtual environments

### Frontend Technologies
1. HTMX
   - Dynamic updates and server interactions
   - Partial rendering and progressive enhancement
   - Server-side processing and form handling
   - See frontendArchitecture.md for detailed implementation

2. AlpineJS
   - UI state management and reactivity
   - Component behavior and lifecycle
   - Event handling and DOM manipulation
   - See frontendArchitecture.md for component patterns

3. Tailwind CSS
   - Utility-first styling with custom configuration
   - Component design system
   - Responsive layouts and dark mode support
   - See frontendArchitecture.md for styling guide

## Integration Patterns

### Template System
1. Base Structure
   - Base templates
   - Partial templates by model
   - Component reuse
   - Template inheritance

2. HTMX Integration
   - Partial updates
   - Server triggers
   - Event handling
   - Response processing

### Data Flow
1. Model Layer
   - Django ORM
   - Database schema
   - Relationships
   - Validation rules

2. View Layer
   - Class-based views
   - Function views
   - Mixins
   - Decorators

3. Template Layer
   - Django templates
   - HTMX partials
   - AlpineJS components
   - Tailwind styles

## Key Libraries/Frameworks

### Django Extensions
1. Core Apps
   - django.contrib.auth
   - django.contrib.admin
   - django.contrib.sessions
   - django.contrib.messages

2. Third-Party
   - django-tailwind
   - django-htmx
   - Additional dependencies

### Frontend Libraries
1. CSS Framework
   - Tailwind CSS with custom configuration
   - Theme system with light/dark mode support
   - Component-specific style patterns
   - See frontendArchitecture.md for complete styling guide

2. JavaScript
   - AlpineJS for reactive components
   - HTMX for server interactions
   - Location autocomplete system
   - Alert and modal components
   - See frontendArchitecture.md for component documentation

3. UI Components
   - Form elements and validation
   - Navigation and menus
   - Status indicators and badges
   - Modal and alert system
   - See frontendArchitecture.md for implementation details

## Infrastructure Choices

### Development Environment
1. Local Setup
   - Python environment
   - Django configuration
   - Tailwind setup
   - Development server

2. Tools
   - VSCode
   - Git
   - Package managers
   - Development utilities

### Production Environment
1. Hosting
   - Server requirements
   - Domain configuration
   - SSL/TLS setup
   - Static/media serving

2. Services
   - Database hosting
   - File storage
   - Email service
   - Monitoring tools

## Technical Constraints

### Development Rules
1. Code Standards
   - Python style guide
   - Django best practices
   - Frontend patterns
   - Documentation requirements

2. Process Requirements
   - Git workflow
   - Testing standards
   - Review process
   - Deployment steps

### Technology Limitations
1. Frontend
   - HTMX/AlpineJS only (no React/Vue/Angular)
   - Progressive enhancement approach required
   - Must support latest 2 versions of major browsers
   - See frontendArchitecture.md for detailed browser support
   - Performance targets:
     * First contentful paint < 1.5s
     * Time to interactive < 2s
     * Core Web Vitals compliance

2. Backend
   - Django version constraints
   - Database limitations
   - API restrictions
   - Security requirements

## Development Environment

### Local Setup
1. Required Software
   - Python
   - pip
   - Git
   - Node.js (for Tailwind)

2. Configuration
   - Environment variables
   - Development settings
   - Database setup
   - Media handling

### Development Tools
1. Editor Setup
   - VSCode configuration
   - Extensions
   - Linting
   - Formatting

2. Testing Tools
   - Django test runner
   - Coverage tools
   - Browser testing
   - Performance testing

## Version Control

### Git Configuration
1. Repository Structure
   - Main branch workflow
   - Commit standards
   - Push requirements
   - Version tracking

2. Process
   - Commit messages
   - Code review
   - Documentation
   - Deployment

## Dependencies

### Python Packages
1. Core Dependencies
   - Django
   - Database adapters
   - Utility packages
   - Testing tools

2. Development Dependencies
   - Debug tools
   - Testing utilities
   - Documentation generators
   - Linting tools

### Frontend Dependencies
1. Required Packages
   - Tailwind CSS
   - AlpineJS
   - HTMX
   - Development tools

2. Build Tools
   - Node.js
   - npm/yarn
   - Build scripts
   - Asset compilation

## Documentation Standards

### Code Documentation
1. Python
   - Docstrings
   - Type hints
   - Comments
   - README files

2. Templates
   - Component documentation
   - HTMX attributes
   - AlpineJS directives
   - Style classes

### Technical Documentation
1. System Documentation
   - Architecture overview
   - Setup guides
   - Deployment process
   - Maintenance procedures

2. Developer Guides
   - Getting started
   - Best practices
   - Common patterns
   - Troubleshooting