Why ShowZ
Most show apps either browse well or discuss well. ShowZ is designed to do both by combining discovery rails, rich show detail, and room-based chat in one flow.
ShowZ Project Showcase Hub
Project Description
ShowZ is a native SwiftUI iOS app for TV discovery and discussion, built to combine fast browsing with meaningful show conversation.
Screenshots Version History
Select a version, then scroll horizontally through screenshots from that release.
Version 1
Core Discovery Launch
Introduced For You, Trending, Popular, show detail, and foundational search navigation.
Version 2
Personalization + Chat Overhaul
Improved recommendation logic, refined search, added Ask AI, and launched the new chat system.
Version 3
Recommendation and Chat Polish
Grouped liked shows into a dedicated state, improved recommendations, and polished chat visuals.
V1 - For You
Added For You personalization for TV shows.
V1 - Trending
Added Trending to surface the most trending TV shows.
V1 - Popular
Added Popular to surface the most popular TV shows.
V1 - Show Detail
Added expanded show details with deeper television show context.
V1 - Search
Added search navigation to find and browse different TV shows.
V2 - For You
Tied liked shows into personalization so likes directly shape the feed.
V2 - Trending
Minor enhancements to improve trending accuracy.
V2 - Popular
Minor enhancements to improve popular-lane accuracy.
V2 - Show Detail
Show detail fixes and improvements.
V2 - Search
Search fixes and additions.
V2 - Keyboard Fit
Visual design adjusted to better fit the iOS keyboard.
V2 - Ask AI
Added different AI options to ask more about TV shows.
V2 - Chat
Chat overhaul created a dedicated space and design for user conversations.
V2 - Chat Options
Added clickable chat options users can select.
V3 - For You (Liked)
This section keeps all TV shows you liked in one place.
V3 - For You (Recommended)
Recommended TV shows are based on liked titles; this beta feature is still being tuned for accuracy.
V3 - Chat
Design tweaks were made to the chat experience for better clarity.
Demo Walkthrough
This section hosts the product demo video for reviewers. The player activates automatically when the media file is present.
Demo Video Coming Soon
A guided walkthrough of discovery lanes, show detail flow, and room-based chat will be published here.
Technical Project Notes
Deeper product context plus implementation details for evaluating architecture decisions, data strategy, and local run setup.
Core Capabilities
- For You feed powered by explicit likes and on-device personalization.
- Distinct For You, Trending, and Popular rails for structured discovery.
- TVMaze-first search and detail enrichment for seasons, episodes, and summaries.
- Immersive room-based chat with General, Season, and Episode contexts.
v2.8 Alpha Focus
- Stabilizing local-first chat timelines across per-show room contexts.
- Improving readability and performance under heavier chat histories.
- Tuning immersive per-show theming consistency and fallback guardrails.
- Polishing search-to-detail-to-chat transitions and spoiler controls.
Reliability + Data Strategy
- Primary source: TVMaze API.
- Fallback chain: in-memory cache, 24h disk cache, then local catalog.
- Query-driven debounced search (300ms, minimum 2 characters).
- Deterministic on-device personalization with no backend dependency in alpha.
Architecture
- SwiftUI + async/await + URLSession.
- TVMaze-first feed/search routing.
- Detail loader/enrichment boundaries before render.
Data Strategy
- Primary source: TVMaze API.
- Fallback chain: memory -> 24h disk -> local catalog.
- Personalization from explicit likes only.
Run Locally
- Open `ShowZ.xcodeproj`.
- Select `ShowZ` scheme.
- Choose compatible iPhone runtime.
- Build and run (target: iOS 26.2).
Roadmap
- Stabilize chat behavior and history performance.
- Expand immersive theme coverage consistency.
- Finalize spoiler UX and evaluate backend sync post-beta.