How vengatz-git/inspirestack works
InspireStack is a social discovery application for creating and browsing visual pins, organizing them into boards, and interacting through profiles, follows, comments, likes, saves, and notifications. Users authenticate and onboard, then create pins or explore feeds, search, topics, and profiles; profile and settings workflows support identity and privacy preferences. The graph includes major feature areas from the tree, but unsampled feature internals are represented at directory level. Edges are limited to relationships shown in excerpts or the source index.
Main entry points: (app) App routes · auth.ts Authentication · get-feed.ts Feed service · index.ts PostgreSQL data
Components 24
Application entry
- App routes
app/(app) - Landing experience
features/landing/components/landing-page.tsx - Onboarding
features/onboarding - Account settings
app/(app)/settings/page.tsx - Feed API
app/api/feed/route.ts - Follow-list API
app/api/profile/[username]/follows/route.ts - Notification stream
app/api/notifications/stream/route.ts
Pins and discovery
- Feed service
features/feed/services/get-feed.ts - Masonry feed
features/feed/components/masonry-engine.tsx - Pin detail and actions
features/pin - Pin creation and drafts
features/upload - Boards
features/board - Search
features/search - Topics
features/topic
Social features
- Profiles
features/profile - Follow and mute
features/profile/services/follow-user.ts - Comments
features/comment - Pin likes
features/like - Saved pins
features/saved - Notifications
features/notification
Identity and persistence
- Authentication
auth.ts - PostgreSQL data
db/index.ts - Domain schema
db/schema/auth.ts
Other components
- Visitor or member
Connections 37
- Visitor or member → App routes: browses
README.md - App routes → Landing experience: renders
- App routes → Feed service: loads
- Feed service → PostgreSQL data: queries
features/feed/services/get-feed.ts - Feed service → Saved pins: checks saved IDs
features/feed/services/get-feed.ts - Feed service → Boards: checks saved boards
features/feed/services/get-feed.ts - Feed service → Masonry feed: supplies pins
- Masonry feed → Pin detail and actions: places pin cards
features/feed/components/masonry-engine.tsx - App routes → Pin creation and drafts: opens creation
app/(app)/create/page.tsx - App routes → Boards: loads user boards
app/(app)/create/page.tsx - App routes → Topics: loads topic options
app/(app)/create/page.tsx - App routes → Authentication: checks session
app/(app)/create/page.tsx - App routes → Profiles: loads profile
app/(app)/profile/[username]/page.tsx - Profiles → PostgreSQL data: reads profile
features/profile/services/get-profile-by-username.ts - App routes → Follow and mute: checks follow status
app/(app)/profile/[username]/page.tsx - App routes → Boards: loads boards
app/(app)/profile/[username]/page.tsx - App routes → Pin detail and actions: loads user pins
app/(app)/profile/[username]/page.tsx - App routes → Authentication: checks session
app/(app)/profile/[username]/page.tsx - Follow and mute → PostgreSQL data: queries and updates
features/profile/services/follow-user.ts - App routes → Account settings: opens settings
- Account settings → Authentication: checks session
app/(app)/settings/page.tsx - Account settings → Profiles: loads profile
app/(app)/settings/page.tsx - Feed API → Authentication: checks session
app/api/feed/route.ts - Feed API → Feed service: requests feed
app/api/feed/route.ts - Follow-list API → Profiles: resolves username
app/api/profile/[username]/follows/route.ts - Follow-list API → Follow and mute: gets follow list
app/api/profile/[username]/follows/route.ts - Follow-list API → Authentication: checks viewer
app/api/profile/[username]/follows/route.ts - Notification stream → Authentication: checks session
app/api/notifications/stream/route.ts - Notification stream → Notifications: subscribes to events
app/api/notifications/stream/route.ts - Authentication → PostgreSQL data: uses adapter
auth.ts - Authentication → Domain schema: configures auth tables
auth.ts - Domain schema → PostgreSQL data: defines persisted entities
db/schema/auth.ts - Visitor or member → Onboarding: sets up account
README.md - Visitor or member → Search: discovers content
README.md - Visitor or member → Comments: comments on pins
README.md - Visitor or member → Pin likes: likes pins
README.md - Visitor or member → Notifications: views activity
README.md