How hngwu/portfolio works
This is a Next.js portfolio with two connected product surfaces: public-facing interactive career/project content and an authenticated admin for editing tiles and detailed records, switching database providers, and synchronizing data. A typical visitor opens the bento portfolio, whose content is assembled from database records and rendered as tiles, then visits project or career-detail pages. The repository also includes distinct CV, education-map, skills-astrolabe, and mechanical-deity experiences. Admin action and storage links are based on excerpts; unsampled feature wiring is not inferred.
Main entry points: index.ts Database access · app/page.tsx Portfolio home · DetailShell.tsx Detail shell · projects/page.tsx Project listings
Components 23
Public portfolio
- Portfolio home
app/page.tsx - Bento grid
components/bento/ClientBentoGrid.tsx - Tile renderer
components/bento/TileRenderer.tsx - Project listings
app/projects/page.tsx - Project detail
components/projects/ProjectDetailClient.tsx - Detail shell
components/detail/DetailShell.tsx - Career pages
app/experience/page.tsx
Interactive experiences
- CV dossier
components/cv/CvDossierViewer.tsx - Education map
components/education/EducationMap.tsx - Skills astrolabe
components/skills/CelestialAstrolabe.tsx - Mechanical deity
components/deity/MechanicalDeityCenterpiece.tsx
Admin and editing
- Tile editor
app/admin/(dashboard)/tiles/page.tsx - Tile actions
app/actions/tiles.ts - Admin sessions
lib/auth/session.ts - Provider controls
app/actions/database.ts - Database sync UI
components/admin/DatabaseSyncModal.tsx - Sync actions
app/actions/database-sync.ts
Content and storage
- Portfolio assembly
lib/content/portfolio.ts - CV documents
lib/cv/documents.ts - Database access
lib/db/index.ts - SQLite store
lib/db/index.ts - Supabase
lib/db/supabase.ts
Other components
- Visitor
Connections 20
- Visitor → Portfolio home: opens
app/page.tsx - Portfolio home → Bento grid: renders
app/page.tsx - Bento grid → Tile renderer: uses
components/bento/ClientBentoGrid.tsx - Portfolio home → Database access: loads tiles
app/page.tsx - Portfolio assembly → Database access: loads records
lib/content/portfolio.ts - Project listings → Detail shell: wraps page
app/projects/page.tsx - Project listings → Project detail: renders carousel
app/projects/page.tsx - Project detail → Detail shell: uses
components/projects/ProjectDetailClient.tsx - Career pages → Portfolio assembly: reads content
app/experience/page.tsx - Career pages → Detail shell: presents detail
- CV dossier → CV documents: loads documents
- Tile editor → Tile actions: loads and saves
app/admin/(dashboard)/tiles/page.tsx - Tile actions → Database access: accesses records
app/actions/tiles.ts - Tile editor → Tile renderer: previews tiles
app/admin/(dashboard)/tiles/page.tsx - Provider controls → Admin sessions: validates session
app/actions/database.ts - Provider controls → Database access: switches provider
app/actions/database.ts - Database sync UI → Sync actions: requests status
components/admin/DatabaseSyncModal.tsx - Sync actions → Admin sessions: checks session
app/actions/database-sync.ts - Database access → SQLite store: reads and writes
lib/db/index.ts - Database access → Supabase: delegates queries
lib/db/index.ts