How heyjunpenn/awesome-jev works
Awesome Jev is a multilingual catalog website for discovering and evaluating verified Jev-related open-source projects. Visitors browse the catalog by category, language, search terms, and recency; they can also explore curated real-world demos and project history. A separate sponsorship workflow supports checkout, payment confirmation, sponsor listings, and logo assets. The graph reflects documented site capabilities and sampled API behavior; some page-to-library wiring is inferred from route and module responsibilities, since those source files were not sampled.
Main entry points: index.astro Home and catalog pages · webhook.ts Payment webhook · sponsor-logo.ts Logo discovery and storage · [locale].json.ts Showcase feed API
Components 28
Project discovery
- Home and catalog pages
src/pages/[locale]/index.astro - Filtered project pages
src/pages/[locale]/projects/[filter].astro - Catalog JSON APIs
src/pages/catalog/[locale].json.ts - Catalog data access
src/lib/catalog.ts - Catalog navigation data
src/data/catalog-navigation.ts - Changelog pages
src/pages/[locale]/changelog.astro
Showcase
- Showcase pages
src/pages/[locale]/showcase.astro - Showcase category pages
src/pages/[locale]/showcase/[category].astro - Showcase feed API
src/pages/api/showcase/[locale].json.ts - Feed filtering and paging
src/lib/showcase-feed.ts - Demo manifest
src/data/showcase.json - Showcase filters
src/lib/showcase-filter.ts
Sponsorship
- Sponsor pages
src/pages/[locale]/sponsors.astro - Sponsor listing API
src/pages/api/sponsors/index.ts - Checkout API
src/pages/api/sponsors/checkout.ts - Payment webhook
src/pages/api/sponsors/webhook.ts - Sponsor click API
src/pages/api/sponsors/click.ts - Sponsor data and ranking
src/lib/sponsors.ts - Payment verification
src/lib/sponsor-payment.ts - Logo discovery and storage
src/lib/sponsor-logo.ts - Sponsor database
migrations/0001_sponsors.sql - Logo asset bucket
Shared site services
- Locale messages and config
src/i18n/index.ts - Star history image API
src/pages/api/star-history.png.ts
Other components
- Visitor
- Stripe
- Sponsor websites
- Star history service
Connections 33
- Visitor → Home and catalog pages: browses
- Visitor → Filtered project pages: filters projects
- Visitor → Catalog JSON APIs: requests catalog
- Home and catalog pages → Catalog data access: loads catalog
- Filtered project pages → Catalog data access: loads catalog
- Catalog JSON APIs → Catalog data access: loads and sorts
- Home and catalog pages → Catalog navigation data: reads navigation
- Visitor → Changelog pages: reads updates
- Visitor → Showcase pages: explores demos
- Visitor → Showcase category pages: filters demos
- Showcase pages → Showcase feed API: requests feed
- Showcase category pages → Showcase feed API: requests feed
- Showcase feed API → Feed filtering and paging: builds page
- Showcase feed API → Demo manifest: reads videos
- Feed filtering and paging → Showcase filters: filters results
- Visitor → Sponsor pages: views sponsors
- Sponsor pages → Sponsor listing API: loads listings
- Sponsor listing API → Sponsor data and ranking: gets ranked sponsors
- Visitor → Checkout API: starts sponsorship
- Checkout API → Stripe: creates checkout
- Stripe → Payment webhook: posts payment event
- Payment webhook → Payment verification: verifies session
- Payment webhook → Sponsor database: upserts sponsor
- Payment webhook → Logo discovery and storage: ensures logo
- Logo discovery and storage → Sponsor database: reads and updates
- Logo discovery and storage → Sponsor websites: fetches icon
- Logo discovery and storage → Logo asset bucket: stores image
- Visitor → Sponsor click API: clicks sponsor
- Sponsor click API → Sponsor data and ranking: records click
- Visitor → Star history image API: requests chart
- Star history image API → Star history service: fetches image
- Home and catalog pages → Locale messages and config: localizes interface
- Showcase pages → Locale messages and config: localizes interface