How elias288/elelispage works
Project type and purpose
• This is a static-site “personal portfolio” built with Astro JS.
• The goal is to showcase projects, skills, and experience as a self-contained website that is built once and served as static assets.
File structure
• Top-level “code” folder contains the entire Astro project.
• astro.config.mjs, package.json, tsconfig.json → build config, dependencies, TypeScript setup
• src/pages → route definitions (index.astro → home page)
• src/layouts → shared wrappers (Header, Footer, Layout)
• src/components → reusable UI pieces (Welcome, SobreMi, Experiencia, etc.)
• src/content/proyectos → project detail files (each .astro is a content page)
• src/assets & static/images → raw images and static files
• src/utils & src/types → helpers (loadProjects.ts) and type definitions
• .github/workflows/deploy.yml defines the CI/CD pipeline for automated build & deploy.
Key insights from README
• Confirms it’s an Astro-based portfolio.
• No dynamic backend or database—pure static generation.
a. Components to include
1. Developer Workstation
• Local code editor (VSCode), source files under code/src
2. Version Control (GitHub Repo)
• code/, .github/workflows/deploy.yml
3. CI/CD Pipeline (GitHub Actions)
• Checkout code, npm install, npm run build (Astro SSG), deploy step
4. Static Site Hosting / CDN
• Host (e.g., GitHub Pages, Netlify, Vercel) serving the generated /dist folder
5. End-User Browser
• Requests HTML, CSS, JS, images from CDN/host
6. External Services (optional)
• Analytics, form-submission endpoint (if any)
b. Relationships & data flow
c. Architectural patterns & principles
• Static Site Generation (SSG) with Astro
• Component-based UI (atomic design: pages → layouts → components)
• Content-as-code (project pages under src/content)
• CI/CD for automated, repeatable builds and deployments
d. Key technologies
• Astro JS framework
• Node.js & npm (package.json, package-lock.json)
• TypeScript (tsconfig.json, .ts files)
• GitHub Actions (deploy.yml)
• Static host / CDN (e.g., Netlify, Vercel)