How oscarfdiaz/portfolio works
The project is a personal portfolio website built using Vite and React, with a modern tech stack including TypeScript, SASS, animate.css, and i18next for internationalization. The overall purpose is to showcase the portfolio through well-organized and visually appealing sections, incorporating interactive elements such as easter eggs (e.g., the Konami code) and smooth transitions/animations.
Main Components
• Client-Side Application: This is the core component running in the browser.
• Entry Point: index.html and src/main.tsx which initialize the React application.
• UI Components: All individual React components grouped by features such as Home, About, Works, Contact, Navigator, and even the fun Konami module.
• Layouts: Specialized layout components (Footer, Navigator, SectionAbout, SectionContact, SectionMain, SectionWorks, SocialIcons) that dictate the overall page structure and navigation.
• Assets and Resources:
• Styles: SCSS files under src/styles that include component-specific and global style definitions.
• Helpers and Data Providers:
• JSON Helpers: Modules in src/helpers/json (e.g., navigatorItems, worksItems, designItems) serving as content/config for dynamic rendering.
• Utility Functions: Helpers such as konamicode.ts and matrix.ts managing interactivity or data transformations.
• Internationalization:
• i18n Setup: Managed under src/lang with configurations and language definitions.
Relationships and Interactions
• The index.html loads the bundled React application initialized via src/main.tsx.
• The main application renders high-level layout components (SectionMain, SectionAbout, etc.), which in turn compose smaller, specialized UI components.
• Data and configuration for sections like the navigator or works showcase are provided via JSON helper files.
• Assets and SASS styles are consumed by various components, ensuring consistent theming and iconography throughout the site.
• The i18next configuration (inside src/lang) integrates with React components for language switching.
Architectural Patterns and Design Principles
• Component-Based Architecture: Every feature (e.g., About, Contact, Works) is encapsulated in its own React component directory, which promotes modularity and reusability.
• Separation of Concerns: Layouts handle the overall structural presentation while individual components manage specific interface pieces.
• Configuration as Code: The use of JSON helpers to provide data means that the content is loosely coupled with the presentation logic.
• Responsive Design / Theming: SASS and animate.css are used for styling and animations, indicating a focus on a dynamic yet organized user interface.
• Internationalization (i18next): Ensures that language-specific content is decoupled and easily maintained.
Relevant Technologies and Frameworks
• Vite (Build Tool): Manages project bundling and development server setup.
• React: The core UI library.
• TypeScript: Provides static typing across the application.
• SASS: Modular styling via SCSS files.
• animate.css: For CSS-based animations.
• i18next: For managing translations and internationalization.