How adrienpoly/rubyvideo works
Main Components
a. Frontend Layer:
• Hotwire (Turbo + Stimulus)
• Vite for asset bundling
• Tailwind CSS with daisyUI
• View Transitions API integration
b. Application Layer:
• Ruby on Rails application server
• Controllers structure (standard + API endpoints)
• Avo admin panel
• Authentication system
• Background job processing (Solid Queue)
c. Data Layer:
• SQLite database
• Solid Cache for caching
• Meilisearch for search functionality
• File storage for assets
d. External Services:
• YouTube API integration
• GitHub integration
• AppSignal for monitoring
• Kamal for deployment
┌─────────────────────────────────────────────────────────────┐
• Client Layer │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• Browser │ │ Hotwire │ │ Vite │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┬─────────────────────────────────┘
┌───────────────────────────┼─────────────────────────────────┐
• ▼ │
• Application Layer │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• Rails App │ │ Avo Admin │ │ Solid │ │
• ◄─►│ Panel │◄─►│ Queue │ │
• ┘ └─────────────┘ └─────────────┘ │
• ▲ ▲ ▲ │
• ┼────────────────┼────────────────┼─────────────────┘
┌─────────┼────────────────┼────────────────┼─────────────────┐
• ▼ ▼ ▼ │
• Data Layer │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• SQLite │ │ Meilisearch │ │ Solid │ │
• Database │ │ │ │ Cache │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┬─────────────────────────────────┘
┌───────────────────────────┼─────────────────────────────────┐
• ▼ │
• External Services │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• YouTube │ │ GitHub │ │ AppSignal │ │
• API │ │ API │ │ │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┘
Key Relationships to Highlight
• Hotwire's real-time updates flow
• Background job processing path
• Search functionality flow
• Authentication flow
• Video processing pipeline
Important Implementation Details
• MVC pattern within Rails
• Event-driven architecture for real-time features
• Caching points
• Security boundaries
Deployment Flow
• Kamal deployment pipeline
• Docker container organization
• Monitoring points