How joselriascos/web_portfolio works
Project type and purpose
• This is a single‐page React web portfolio (“WEB PORTFOLIO”).
• Built with Vite, it serves as a front-end showcase (no dedicated backend/service code).
File structure
• Top-level:
– index.html, public/ (static assets + redirect rules), package.json, vite.config.js
• src/:
– main.jsx: entrypoint bootstrapping React into index.html
– App.jsx / App.css: root component and styling
– routes/router.jsx: defines client-side routes (Home, AboutMe, Contact, ProjectPage, 404)
– pages/: page containers rendered by the router
– Components/: reusable UI pieces (Header, Footer, WorkSection, Project, ContactInfo, LogoLoop, Particles, etc.)
– contexts/AppContext.jsx & hooks/useAppContext.js: global state via React Context
– data/projects.json: static project metadata
– hooks/: custom hooks (useTitle, useCarousel, useHeader, useDisableScroll)
– utils/: shared constants & helper functions
Key architectural insights from README
• A static SPA meant for deployment on a static host (Netlify, Vercel, S3).
• Uses client-side routing and component composition to render dynamic sections.
Elements
– Clear component labels: e.g., “Router”, “HomePage”, “ProjectList Component”
• From Browser → Static Host → index.html
• index.html → React Mount Point → App Component
• Router → Pages → Components → Data
Putting it all together
• Under Static Host, show index.html + bundle.js/css + public assets.
– Context Provider → Router Layer → Page Components → UI Components
• Custom hooks and their roles (e.g., useTitle sets document.title).