How saksham953/book-buddy works
BookBuddy is a Next.js/React bookstore backed by a Flask API and AWS services. The intended customer journey is discovery and cart building, Stripe checkout, then order tracking; admins also manage the catalog. The sampled webhook does not create backend orders, while the orders page excerpt builds a local order after checkout success, so the documented end-to-end flow is not fully wired in the shown code. Connections for unsampled features follow README documentation rather than inspected implementation.
Main entry points: app.py Flask API · app/page.tsx Landing page · route.ts Checkout route · browse/page.tsx Book discovery
Components 17
Storefront
- Landing page
book/app/page.tsx - Hero experience
book/components/ui/cinematic-landing-hero.tsx - Feature cards
book/components/blocks/features-2.tsx - Testimonials
book/components/ui/testimonial-v2.tsx - Book discovery
book/app/browse/page.tsx - Catalog admin
book/app/admin/page.tsx
Commerce
- Checkout route
book/app/api/checkout/route.ts - Stripe Checkout
- Stripe webhook
book/app/api/webhooks/stripe/route.ts - Order tracking
book/app/orders/page.tsx
Backend API
- Flask API
backend/app.py - Catalog endpoints
backend/app.py - Order endpoints
backend/app.py
Cloud Services
- DynamoDB
- AWS SNS
- Clerk auth
Other components
- Reader
Connections 21
- Reader → Landing page: visits
README.md - Landing page → Hero experience: renders
book/app/page.tsx - Landing page → Feature cards: renders
book/app/page.tsx - Landing page → Testimonials: renders
book/app/page.tsx - Hero experience → Book discovery: links to
book/components/ui/cinematic-landing-hero.tsx - Reader → Book discovery: discovers books
README.md - Book discovery → Flask API: requests catalog
README.md - Reader → Checkout route: starts checkout
- Checkout route → Clerk auth: checks identity
book/app/api/checkout/route.ts - Checkout route → Stripe Checkout: creates session
book/app/api/checkout/route.ts - Stripe Checkout → Stripe webhook: posts event
README.md - Stripe webhook → Flask API: would submit order
- Reader → Order tracking: views tracking
README.md - Order tracking → Flask API: requests order history
README.md - Catalog admin → Clerk auth: checks identity
book/app/admin/page.tsx - Catalog admin → Flask API: manages books
book/app/admin/page.tsx - Flask API → Catalog endpoints: routes requests
backend/app.py - Flask API → Order endpoints: routes requests
backend/app.py - Catalog endpoints → DynamoDB: scans and writes
backend/app.py - Order endpoints → DynamoDB: reads and writes
backend/app.py - Order endpoints → AWS SNS: publishes order alert
backend/app.py