How jhonatan0912/portfolio works
Project Type and Purpose
• Project Type: A single-page, client-side portfolio web application.
• Purpose: To display personal projects, experiences, skills, and additional information (like a resume PDF) to potential employers or clients, using a dynamic Vue component structure.
File Structure
• The “src” directory is the core of the application and contains:
• Main entry point: index.html and src/main.ts that bootstraps the Vue application.
• Root component: App.vue, which ties together the overall layout.
• Components: A set of Vue components (e.g., Experience.vue, Projects.vue, Skills.vue, Info.vue) and specialized UI components under src/components/ui (e.g., Header.vue, LanguageToggle.vue, etc.).
• Constants and Interfaces: Located under src/constants and src/interfaces, defining languages, projects, skills, and social information. These are the data models feeding into your components.
• Helpers: Such as the i18n.ts file which handles internationalization.
• The assets folder (under src/assets) holds fonts and possibly other media files used by the components.
a. Main Components:
• Entry & Bootstrapping:
• index.html: The host HTML page that loads the application.
• src/main.ts: Sets up the Vue app.
• App.vue: Acts as the root component.
• UI Components:
• Primary sections: Experience, Projects, Skills, and Info components.
• Reusable UI components under src/components/ui (Header, LanguageToggle, ProjectCard, ResumeButton, SkillCard, SocialButton, ThemeButton, TitleSection).
• Special effects like CursorTrail.vue.
• Data & Configuration Layer:
• Constants: language, projects, skills, and social definitions.
• Interfaces: Type definitions used throughout the project.
• i18n helper: Facilitates internationalization.
• Static Assets:
• Configuration & Build Tools:
• Vite, Tailwind, PostCSS configuration files.
• TypeScript configuration files.
b. Relationships and Interactions:
• The browser loads index.html which links to main.ts.
• main.ts initializes the Vue instance, rendering App.vue.
• App.vue serves as a container that integrates the various sections (Experience, Projects, etc.) and its child UI components.
• Each component dynamically receives data (supplied from the constants and interfaces) and renders them visually.
• The i18n helper and language constants manage language toggles impacting how text content is presented.
c. Important Architectural Patterns and Design Principles:
• Component-based Architecture: The project splits the UI into self-contained, reusable Vue components.
• Separation of Concerns: Clear distinction between presentation (components), logic (helpers and constants), and static assets.
• Data-driven design: The use of constants and interfaces ensures the display of portfolio content is dynamic and maintainable.
• Use of modern tooling: Vite provides efficient build and hot module replacement; Tailwind CSS offers utility-first styling.
d. Relevant Technologies and Frameworks:
• Vue.js: For building reactive UI components.
• TypeScript: For type safety and well-defined data structures.
• Vite: A modern build tool optimizing development and production builds.
• Tailwind CSS and PostCSS: For styling.
• i18n: For multi-language support via a helper module and corresponding constants.