How kkrugley/safepaws works
SafePaws is a multilingual website for browsing free cat-shelter designs, downloading fabrication files, and finding nearby workshops. The main user journey runs from the product catalog to product details and downloads, then on to fabrication and assembly; the site also supports community stories and ideas, a quiz and materials calculator, workshop discovery, and user submissions. The sampled code confirms catalog rendering and workshop-search adapters, but most API and data connections were not shown, so those relationships are omitted or marked unverified.
Main entry points: SolutionsClient.tsx Product catalog · workshops.ts Workshop services · WorkshopFinder.tsx Workshop search · websearch.ts Web search adapter
Components 20
Product discovery
- Product catalog
website/src/app/solutions/SolutionsClient.tsx - Product content
website/src/data/products.ts - Product details
website/src/app/solutions/[slug]/page.tsx - Product quiz
website/src/components/ui/QuizSection.tsx
Build resources
- Download center
website/src/app/download/DownloadContent.tsx - Materials calculator
website/src/components/ui/MaterialsCalculator.tsx - Build guidance
website/src/app/help/HelpContent.tsx
Community
- Community stories
website/src/lib/stories.ts - Community ideas
website/src/lib/ideas.ts - User submissions
website/src/app/api/ideas/route.ts
Workshop finder
- Workshop search
website/src/app/solutions/find-workshop/WorkshopFinder.tsx - Workshop services
website/src/lib/workshops.ts - Web search adapter
website/src/lib/workshop-sources/websearch.ts - Firecrawl search
website/src/lib/workshop-sources/firecrawl.ts - OpenStreetMap source
website/src/lib/workshop-sources/osm.ts
Website services
- Download endpoint
website/src/app/api/downloads/route.ts - Geocoding endpoint
website/src/app/api/geocode/route.ts - Notify subscriptions
website/src/app/api/notify-subscribe/route.ts - Neon database
website/src/lib/db.ts
Other components
- Visitor
Connections 18
- Visitor → Product catalog: browses
- Product catalog → Product content: loads products
website/src/app/solutions/SolutionsClient.tsx - Product catalog → Product details: opens details
website/src/app/solutions/SolutionsClient.tsx - Visitor → Download center: downloads files
- Product catalog → Download center: links downloads
website/src/app/solutions/SolutionsClient.tsx - Visitor → Product quiz: takes quiz
- Visitor → Materials calculator: calculates materials
- Visitor → Build guidance: reads instructions
- Visitor → Community stories: shares stories
- Visitor → User submissions: submits ideas
- Visitor → Workshop search: searches workshops
- Workshop search → Workshop services: requests search
- Workshop services → Web search adapter: uses adapter
website/src/lib/workshop-sources/websearch.ts - Web search adapter → Firecrawl search: calls search
website/src/lib/workshop-sources/websearch.ts - Workshop services → OpenStreetMap source: may use source
- Visitor → Notify subscriptions: requests updates
- Visitor → Geocoding endpoint: geocodes location
- Download endpoint → Neon database: may read records