Ordo Kino

Ordo Kino is a complete self-hosted media platform that transforms a personal media collection into a Netflix-grade experience. The goal was to provide a private, secure streaming service for family and friends with professional-level UX.

The system operates across two domains: the web interface routes through a Contabo VPS reverse proxy, keeping the home server's IP hidden, while video streaming connects directly to the hardware via signed URL tokens for maximum performance.

The platform integrates with TMDB for discovery: trending movies and series, genre filtering, detailed pages with cast and ratings. Search uses debounced autocomplete — suggestions appear instantly as you type. The e-book section features Google Books autocomplete, and downloaded PDFs can be read online or sent to Kindle.

Security was a top priority: JWT authentication with PBKDF2-SHA512 password hashing, registration key system (admin-generated, single-use), role-based access control (admin/user), brute-force protection with rate limiting, and every API call recorded in an activity log.

The zero-downtime deploy system alternates between two ports (blue-green), with Caddy health checks automatically routing to the live instance — users experience zero interruption during updates.

The project was built using Agentic Development methodology: most of the development was performed by an AI assistant under human supervision and creative direction. 100+ tests, TypeScript strict mode (zero 'any' types), WHY-focused JSDoc comments, and detailed Mermaid architecture diagrams document the entire system.