How frankji1019/portfolio works
This repository combines a public portfolio, an editing CMS, and Lambda-backed content services. The main workflow is an administrator editing section data in the CMS, which calls the REST API to persist JSON in S3; the portfolio fetches that content at request time and renders its sections. Separate documented branches handle guest/read-only access, Cognito authentication, resume discovery and Google Drive-to-S3 synchronization, and portfolio revalidation. Backend and several portfolio/CMS features are represented from the README and file tree where implementation excerpts were unavailable.
Main entry points: page.tsx Portfolio app · App.tsx CMS router · portfolio-sync-resume.ts Sync resume · portfolio-data-provider.tsx Portfolio data
Components 27
CMS editing
- CMS router
cms/src/App.tsx - CMS authentication
cms/src/providers/AuthProvider.tsx - Login screen
cms/src/pages/LoginPage/LoginPage.tsx - Section editors
cms/src/pages - Experience editor
cms/src/pages/ExperiencePage/ExperiencePage.tsx - Form controls
cms/src/components/FormControls.tsx - Save handling
cms/src/hooks/useSaveHandler.ts - Visibility editor
cms/src/hooks/useSectionVisibility.ts - Resume tools
cms/src/pages/ResumePage/ResumePage.tsx - Section API hooks
cms/src/api-hooks/content-section.ts - Resume API hooks
cms/src/api-hooks/resume.ts
Content services
- Fetch all sections
cms-service-functions/src/portfolio-fetch-all.ts - Section CRUD
cms-service-functions/src/portfolio-sections.ts - List resumes
cms-service-functions/src/portfolio-list-resumes.ts - Sync resume
cms-service-functions/src/portfolio-sync-resume.ts
Public portfolio
- Portfolio app
portfolio/src/app/page.tsx - Portfolio data
portfolio/src/components/portfolio-data-provider.tsx - Rendered sections
portfolio/src/components - Terminal experience
portfolio/src/components/terminal.tsx - SEO and discovery
portfolio/src/app/sitemap.ts - Cache revalidation
portfolio/src/app/api/revalidate/route.ts
Cloud services
- REST API Gateway
- S3 content and resumes
- AWS Cognito
- Google Drive API
- SSM credentials
Other components
- Admin / guest
Connections 32
- Admin / guest → CMS router: uses CMS
README.md - CMS router → CMS authentication: checks role
cms/src/App.tsx - CMS router → Login screen: routes login
cms/src/App.tsx - Login screen → CMS authentication: submits credentials
cms/src/providers/AuthProvider.tsx - CMS authentication → AWS Cognito: authenticates
README.md - CMS router → Section editors: routes sections
cms/src/App.tsx - Section editors → Section API hooks: loads and saves
cms/src/pages/AboutPage/index.tsx - Experience editor → Form controls: renders controls
cms/src/pages/ExperiencePage/ExperiencePage.tsx - Experience editor → Save handling: delegates save
cms/src/pages/ExperiencePage/ExperiencePage.tsx - Visibility editor → Section API hooks: reads and updates
cms/src/hooks/useSectionVisibility.ts - Resume tools → Resume API hooks: requests resume ops
- Section API hooks → REST API Gateway: HTTP section calls
README.md - Resume API hooks → REST API Gateway: HTTP resume calls
README.md - REST API Gateway → Section CRUD: routes section calls
README.md - REST API Gateway → Fetch all sections: routes content fetch
README.md - REST API Gateway → List resumes: routes resume listing
README.md - REST API Gateway → Sync resume: routes resume sync
README.md - Fetch all sections → S3 content and resumes: reads all content
README.md - Section CRUD → S3 content and resumes: reads and writes
README.md - List resumes → Google Drive API: lists Drive files
README.md - Sync resume → Google Drive API: exports document
README.md - Sync resume → S3 content and resumes: stores PDF
README.md - Sync resume → SSM credentials: loads credentials
README.md - Admin / guest → Portfolio app: visits portfolio
README.md - Portfolio app → Portfolio data: renders with data
- Portfolio data → REST API Gateway: fetches all sections
README.md - Portfolio data → Fetch all sections: receives content
- Portfolio data → S3 content and resumes: content sourced from
- Portfolio app → Rendered sections: presents content
- Portfolio app → Terminal experience: offers terminal mode
- Portfolio app → SEO and discovery: provides SEO outputs
README.md - Cache revalidation → Portfolio app: revalidates site