How gwill1337/petnetflix works
PetNetflix is a full-stack movie browsing app. Users browse and search a movie catalog, view movie details, and—when signed in—manage favorites and comments. The React app serves the browsing flow and calls the FastAPI API; authentication supports passwords and Google OAuth, with refreshable cookie sessions. The backend routers own their domain operations and use SQLAlchemy models for PostgreSQL state. README documents the major capabilities; some frontend component-to-API calls and router registrations are supported only at the documentation or import-reference level, so uncertain links are omitted.
Main entry points: main.py FastAPI app · db.py SQLAlchemy models · App.tsx Movie catalog · oauth.py Google OAuth
Components 29
Web app
- App routes
frontend/src/MainRoutes.tsx - Movie catalog
frontend/src/App.tsx - Movie cards
frontend/src/components/MovieCard.tsx - Movie details
frontend/src/pages/MovieDetails.tsx - Comments UI
frontend/src/components/Comments.tsx - Favorite control
frontend/src/components/FavoriteButton.tsx - Header and search
frontend/src/components/Header.tsx - Sign-in modal
frontend/src/components/AuthModal.tsx - Auth provider
frontend/src/components/AuthProvider.tsx - Auth state
frontend/src/context/auth.context.ts - Auth hook
frontend/src/hooks/useAuth.ts - Theme provider
frontend/src/components/ThemeProvider.tsx - Theme state
frontend/src/context/theme.context.ts - Debounce hook
frontend/src/hooks/useDebounce.ts - API configuration
frontend/src/config/config.ts
API services
- FastAPI app
core/main.py - Movie endpoints
core/routers/movies.py - Favorite endpoints
core/routers/favorites.py - Comment endpoints
core/routers/comments.py - Backend settings
core/config.py - API schemas
core/schemas.py
Identity
- Password auth
core/routers/auth.py - Google OAuth
core/routers/oauth.py - Token security
core/security.py
Persistence
- SQLAlchemy models
core/db.py - PostgreSQL
Other components
- Movie viewer
- Google identity
- Backend API
Connections 28
- Movie viewer → App routes: uses
- App routes → Movie catalog: routes to
frontend/src/MainRoutes.tsx - App routes → Movie details: routes to
frontend/src/MainRoutes.tsx - Movie catalog → Backend API: fetches movies
frontend/src/App.tsx - Movie catalog → Movie cards: renders
frontend/src/App.tsx - Movie cards → Favorite control: renders
frontend/src/components/MovieCard.tsx - Movie details → Comments UI: renders
frontend/src/pages/MovieDetails.tsx - Header and search → Sign-in modal: opens
frontend/src/components/Header.tsx - Auth provider → Auth state: provides
frontend/src/components/AuthProvider.tsx - Auth hook → Auth state: reads
frontend/src/hooks/useAuth.ts - Theme provider → Theme state: provides
frontend/src/components/ThemeProvider.tsx - Movie catalog → Debounce hook: imports
frontend/src/App.tsx - Backend API → FastAPI app: sends requests
- FastAPI app → Movie endpoints: registers
core/main.py - FastAPI app → Favorite endpoints: registers
core/main.py - FastAPI app → Comment endpoints: registers
core/main.py - FastAPI app → Password auth: registers
core/main.py - FastAPI app → Google OAuth: registers
core/main.py - Password auth → SQLAlchemy models: queries
core/routers/auth.py - Password auth → Token security: issues tokens
core/routers/auth.py - Google OAuth → SQLAlchemy models: queries
core/routers/oauth.py - Google OAuth → Token security: issues tokens
core/routers/oauth.py - Google OAuth → Google identity: authenticates with
- Movie endpoints → SQLAlchemy models: queries
core/routers/movies.py - Favorite endpoints → SQLAlchemy models: queries
core/routers/favorites.py - Comment endpoints → SQLAlchemy models: queries
core/routers/comments.py - SQLAlchemy models → PostgreSQL: persists
- FastAPI app → Backend settings: loads settings
core/main.py