How ashtym/charityhustle works
This workspace contains several related Charity Hustle experiences, rather than one single application: a community-impact idea finder, a slide deck, and an interactive video, alongside an API server and shared database/OpenAI libraries. The idea-finder workflow is users selecting a country, completing a questionnaire, and exploring saved ideas or organisations; contact and sharing are separate capabilities. The sampled app confirms routing and context ownership, but README content and the implementation of pages, API routes, and persistence were not provided, so those connections are left out where their wiring is uncertain.
Main entry points: App.tsx Impact app · index.ts API routes · VideoTemplate.tsx Video template · ideas.ts Ideas endpoint
Components 26
Impact finder
- Impact app
artifacts/community-impact-generator/src/App.tsx - App context
artifacts/community-impact-generator/src/context/AppContext.tsx - Idea questionnaire
artifacts/community-impact-generator/src/pages/Home.tsx - Charity finder
artifacts/community-impact-generator/src/pages/Charities.tsx - Contact page
artifacts/community-impact-generator/src/pages/Contact.tsx - Site sharing
artifacts/community-impact-generator/src/components/ShareSite.tsx - Idea data
artifacts/community-impact-generator/src/lib/data.ts - Event analytics
artifacts/community-impact-generator/src/lib/analytics.ts
Story experiences
- Slide deck app
artifacts/charity-hustle-deck/src/App.tsx - Slide loader
artifacts/charity-hustle-deck/src/slideLoader.ts - Slide pages
artifacts/charity-hustle-deck/src/pages/slides - Video app
artifacts/charity-hustle-video/src/App.tsx - Video template
artifacts/charity-hustle-video/src/components/video/VideoTemplate.tsx - Video scenes
artifacts/charity-hustle-video/src/components/video/video_scenes - Scene controls
artifacts/charity-hustle-video/src/components/video/useSceneControls.ts
Backend services
- API application
artifacts/api-server/src/app.ts - API routes
artifacts/api-server/src/routes/index.ts - Ideas endpoint
artifacts/api-server/src/routes/ideas.ts - Contact endpoint
artifacts/api-server/src/routes/contact.ts - Health endpoint
artifacts/api-server/src/routes/health.ts
Shared libraries
- Idea database
lib/db/src/schema - Audio integration
lib/integrations-openai-ai-server/src/audio - Image integration
lib/integrations-openai-ai-server/src/image - React API client
lib/api-client-react/src/index.ts
Other components
- Visitor
- OpenAI service
Connections 23
- Visitor → Impact app: browses
- Impact app → App context: provides state
- Impact app → Idea questionnaire: routes to
- Impact app → Charity finder: routes to
- Impact app → Contact page: routes to
- Impact app → Site sharing: offers
- Impact app → Idea data: reads country options
- Impact app → Event analytics: tracks country changes
- Visitor → Slide deck app: views slides
- Slide deck app → Slide loader: loads slides
- Slide loader → Slide pages: resolves slide modules
- Visitor → Video app: views video
- Video app → Video template: renders video
- Video template → Scene controls: controls playback
- Video template → Video scenes: renders scenes
- API application → API routes: mounts routes
- API routes → Ideas endpoint: dispatches ideas
- API routes → Contact endpoint: dispatches contact
- API routes → Health endpoint: dispatches health
- Ideas endpoint → Idea database: uses schema
- Ideas endpoint → Image integration: uses generation
- Audio integration → OpenAI service: requests audio
- Image integration → OpenAI service: requests images