How soodthin/soodfolio-web works
SoodFolio is a portfolio-building and sharing web app. The main workflow is to authenticate, edit and publish a portfolio in the studio, then share a tailored snapshot and review its viewing telemetry. Public portfolio pages support multiple presentation layouts. The README is only a Next.js starter template, so capabilities and relationships here come mainly from the source index and sampled excerpts; links to unsampled behavior are omitted or marked unverified.
Main entry points: VerticalStackDeck.tsx Vertical deck layout · apiClient.ts Authenticated API client · portfolio.ts Portfolio model · page.tsx Shared portfolio
Components 27
Discovery and auth
- Landing experience
app/page.tsx - Login and registration
app/login/page.tsx - Auth presentation
components/auth/StageGateAuthLayout.tsx - Social auth options
components/auth/SocialAuthButtons.tsx - Industry showcase
components/home/CrossIndustryShowcase.tsx
Portfolio studio
- Portfolio dashboard
app/dashboard/page.tsx - Studio interface
components/dashboard/studio/index.ts - Presentation stage
components/dashboard/studio/PresentationStage.tsx
Sharing and analytics
- Share-link manager
app/dashboard/links/page.tsx - Share-link creation
components/dashboard/CreateShareLinkModal.tsx - Telemetry analytics
components/dashboard/TelemetryHeatmapModal.tsx
Public presentation
- Public portfolio
app/[username]/page.tsx - Portfolio preview
app/preview/[username]/page.tsx - Shared portfolio
app/p/[token]/page.tsx - Vertical deck layout
components/deck/VerticalStackDeck.tsx - Minimalist document layout
components/deck/MinimalistPaperDoc.tsx - Deck telemetry
hooks/useDeckTelemetry.ts
Shared foundations
- Session state
context/AuthContext.tsx - Auth session storage
lib/auth.ts - Portfolio model
types/portfolio.ts - Authenticated API client
lib/apiClient.ts - Share-link model
types/shareLink.ts - Theme presets
lib/themePresets.ts - Localization
lib/i18n.ts - Sound effects
lib/sound.ts
Other components
- Visitor
- Application API
Connections 33
- Visitor → Landing experience: opens
- Visitor → Login and registration: opens
- Landing experience → Industry showcase: renders
app/page.tsx - Login and registration → Auth presentation: uses
app/login/page.tsx - Login and registration → Social auth options: uses
app/login/page.tsx - Auth presentation → Theme presets: uses
components/auth/StageGateAuthLayout.tsx - Auth presentation → Localization: uses
components/auth/StageGateAuthLayout.tsx - Session state → Auth session storage: reads and updates
context/AuthContext.tsx - Portfolio dashboard → Authenticated API client: calls
app/dashboard/page.tsx - Portfolio dashboard → Studio interface: loads
app/dashboard/page.tsx - Portfolio dashboard → Portfolio model: uses
app/dashboard/page.tsx - Studio interface → Presentation stage: assembles
components/dashboard/studio/index.ts - Presentation stage → Portfolio model: uses
components/dashboard/studio/PresentationStage.tsx - Authenticated API client → Application API: sends requests
lib/apiClient.ts - Share-link manager → Authenticated API client: calls
app/dashboard/links/page.tsx - Share-link manager → Share-link creation: opens
app/dashboard/links/page.tsx - Share-link manager → Telemetry analytics: opens
app/dashboard/links/page.tsx - Share-link creation → Authenticated API client: calls
components/dashboard/CreateShareLinkModal.tsx - Telemetry analytics → Authenticated API client: calls
components/dashboard/TelemetryHeatmapModal.tsx - Share-link creation → Share-link model: uses
components/dashboard/CreateShareLinkModal.tsx - Telemetry analytics → Share-link model: uses
components/dashboard/TelemetryHeatmapModal.tsx - Public portfolio → Vertical deck layout: renders
app/[username]/page.tsx - Public portfolio → Portfolio model: uses
app/[username]/page.tsx - Portfolio preview → Vertical deck layout: renders
app/preview/[username]/page.tsx - Portfolio preview → Portfolio model: uses
app/preview/[username]/page.tsx - Shared portfolio → Vertical deck layout: renders
app/p/[token]/page.tsx - Shared portfolio → Minimalist document layout: renders
app/p/[token]/page.tsx - Shared portfolio → Deck telemetry: uses
app/p/[token]/page.tsx - Shared portfolio → Share-link model: uses
app/p/[token]/page.tsx - Vertical deck layout → Theme presets: uses
components/deck/VerticalStackDeck.tsx - Vertical deck layout → Localization: uses
components/deck/VerticalStackDeck.tsx - Vertical deck layout → Sound effects: uses
components/deck/VerticalStackDeck.tsx - Minimalist document layout → Portfolio model: uses
components/deck/MinimalistPaperDoc.tsx