How antony-jacob817/my-portfolio works
1. Overall shape
- This is a single-page portfolio application built with React + TypeScript and bundled with Vite.
- The app is organized as a set of reusable UI components and content sections rather than feature modules or backend services.
2. App shell and composition
- src/main.tsx boots the app, and src/App.tsx acts as the top-level composition point.
- The page is assembled from the major sections under src/components/sections, likely in a scroll-based one-page layout.
3. Primary content sections
- The main user-facing areas are Hero, About, Skills, Projects, and Contact.
- These sections represent the portfolio narrative flow: introduction → background → capabilities → work → contact.
4. Layout and navigation
- src/components/layout contains shared chrome such as Header and BottomNavigation.
- This suggests navigation is persistent across sections and designed for quick jumping within the single-page experience.
5. Shared UI primitives
- src/components/core holds cross-cutting interactive elements: ThemeToggle, Loader, CustomCursor, CvDownloadButton, Chatbot.
- These are not tied to a specific content section and form the reusable interaction layer of the site.
6. Theme state boundary
- src/contexts/ThemeContext.tsx centralizes theme mode state and is consumed by the theme toggle and likely by visual styling across the app.
- This is the main explicit application state boundary in the repo.
7. 3D / visual enhancement subsystem
- src/components/3d/SkillSphere.tsx indicates a distinct visual subsystem for animated or 3D-style presentation of skills.
- It is likely embedded in the Skills section as a presentation enhancement rather than as core app logic.
8. Data and external integration
- src/utils/github.ts suggests at least one external data source, probably used to enrich the Projects section with GitHub-derived information.
- This is the clearest sign of a data-fetching boundary in an otherwise mostly static portfolio.
9. Types and shared contracts
- src/types/index.ts provides shared TypeScript types for props, content models, or external data shapes.
- This keeps section components and utility code aligned without introducing heavier state management.
10. Static assets
- public/Antony_Jacob_CV.pdf is a static downloadable asset, wired through the CV download button.
- The public directory is also the place for any other directly served files that do not go through the module bundle.
11. Styling approach
- The presence of tailwind.config.js, postcss.config.js, and src/index.css indicates a Tailwind-based styling stack with a global stylesheet for base rules and overrides.
- Styling is likely component-driven, with theme-aware class switching handled through the context.
12. Build and runtime environment
- The repo is configured with standard frontend tooling: Vite, TypeScript, and ESLint.
- index.html is the Vite entry shell, while tsconfig*.json and vite.config.ts define compile-time and bundling behavior.
13. Architecture summary for a diagram
- The best diagram is a front-end only SPA with one central composition layer, a theme-state context, a shared UI layer, and several content sections.
- The only likely external boundary is optional GitHub data access, plus static asset delivery for the CV PDF.
Main entry points: App.tsx App · index.ts Types · Skills.tsx Skills · Projects.tsx Projects
Components 22
App shell
Bootstrapping and top-level page composition.
Content sections
Main one-page portfolio narrative sections.
- Hero · Introductory landing section.
src/components/sections/Hero.tsx - About · Background and personal summary.
src/components/sections/About.tsx - Skills · Capabilities overview and skill presentation.
src/components/sections/Skills.tsx - Projects · Work showcase and portfolio items.
src/components/sections/Projects.tsx - Contact · Reach-out and contact details.
src/components/sections/Contact.tsx
Shared UI
Reusable chrome and interactive primitives.
- Header · Persistent top navigation chrome.
src/components/layout/Header.tsx - Bottom Nav · Secondary persistent section navigation.
src/components/layout/BottomNavigation.tsx - Theme Toggle · User-facing theme switcher.
src/components/core/ThemeToggle.tsx - Loader · Loading or transition indicator.
src/components/core/Loader.tsx - Custom Cursor · Enhanced pointer interaction layer.
src/components/core/CustomCursor.tsx - CV Download · Triggers download of the resume PDF.
src/components/core/CvDownloadButton.tsx - Chatbot · Interactive conversational UI element.
src/components/core/Chatbot.tsx - Skill Sphere · Animated or 3D skill visualization.
src/components/3d/SkillSphere.tsx
State
Cross-cutting application state boundary.
- Theme Context · Central theme mode state and provider.
src/contexts/ThemeContext.tsx
Data & assets
External data access and static downloadable content.
- GitHub Utils · External GitHub data access for portfolio content.
src/utils/github.ts - Types · Shared TypeScript domain and prop types.
src/types/index.ts - CV PDF · Downloadable resume document.
public/Antony_Jacob_CV.pdf
Connections 27
- main.tsx → App: renders · Bootstraps the application shell.
- App → Header: includes · Composes persistent navigation chrome.
- App → Bottom Nav: includes · Composes persistent section navigation.
- App → Hero: composes · Renders the landing section.
- App → About: composes · Renders the background section.
- App → Skills: composes · Renders the skills section.
- App → Projects: composes · Renders the work showcase section.
- App → Contact: composes · Renders the contact section.
- Theme Toggle → Theme Context: reads/writes · Switches the active theme mode.
- Header → Theme Toggle: contains · Exposes theme switching in the top bar.
- App → Loader: uses · Provides loading feedback within the shell.
- App → Custom Cursor: uses · Adds global pointer interaction.
- App → Chatbot: uses · Mounts the assistant interaction layer.
- App → CV Download: uses · Offers access to the resume download.
- App → Theme Context: provides · Wraps the page with theme state.
- Skills → Skill Sphere: embeds · Uses the visual skill presentation component.
- Projects → GitHub Utils: fetches · Enriches project content from GitHub data.
- CV Download → CV PDF: downloads · Links to the static resume asset.
- App → Types: shares · Uses common types across sections and utilities.
- Hero → Types: uses · Consumes shared content and prop contracts.
- Projects → Types: uses · Consumes shared content and data contracts.
- About → Types: uses · Consumes shared content and prop contracts.
- Skills → Types: uses · Consumes shared content and prop contracts.
- Contact → Types: uses · Consumes shared content and prop contracts.
- App → index.css: styles · Applies global base styling.
- App → Tailwind: configures · Uses Tailwind for utility styling.
- main.tsx → Vite: bundled by · Runs within the Vite toolchain.