diff --git a/replit.md b/replit.md
index bceaf29d..809e180e 100644
--- a/replit.md
+++ b/replit.md
@@ -21,6 +21,7 @@ ThrillWiki is a comprehensive Django-based web application for theme park and ri
 - **Database**: PostgreSQL (DATABASE_URL environment variable)
 - **Server**: Django development server on 0.0.0.0:5000
 - **Spatial Libraries**: GDAL and GEOS configured with correct Nix store paths
+- **Component System**: Django Cotton for modular HTMX frontend components
 - **Settings**: Local development configuration active
 
 #### Database Configuration
@@ -35,6 +36,7 @@ Migrations: All applied successfully (including circular dependency resolution)
 - GeoDjango with PostGIS support
 - Django REST Framework
 - Django Allauth (authentication)
+- Django Cotton (component system)
 - CloudflareImages Toolkit
 - Django PGHistory
 - Pillow (image processing)
@@ -65,6 +67,15 @@ Migrations: All applied successfully (including circular dependency resolution)
 
 ### Recent Setup Work (September 2025)
 
+#### Django Cotton Component System Integration
+1. **Package Installation**: Added django-cotton>=2.1.3 to dependencies via UV package manager
+2. **Configuration**: Integrated Cotton into Django settings via THIRD_PARTY_APPS
+3. **Component Migration**: Converted existing auth modal and toast components to Cotton format
+4. **Template Updates**: Updated base.html to use Cotton syntax (`<c-auth.modal />` and `<c-ui.toast />`)
+5. **Alpine.js Compatibility**: Ensured all existing Alpine.js functionality preserved with Cotton components
+6. **Result**: Modular component system with customizable styling via c-vars, maintaining HTMX/Alpine.js integration
+
+
 #### Database Migration Strategy
 1. **Initial Issue**: Circular dependency between `accounts.0001_initial` and `django_cloudflareimages_toolkit.0001_initial`
 2. **Solution**: Split migrations into stages: