A modern, minimalist portfolio website built with Astro. This static site showcases projects and content with a focus on performance, simplicity, and maintainability.
- Astro - Static site generator for content-focused websites
- Tailwind CSS - Utility-first CSS framework via the Vite plugin
- TypeScript - Type-safe JavaScript
- Fontsource - Self-hosted web fonts
- Markdown - Content authoring
- ⚡ Static site generation with Astro
- 🎨 Tailwind CSS 4 for styling with the typography plugin
- 📝 Content authored in Markdown
- 🖼️ Astro asset pipeline for optimized local images
- 🗺️ Automatic sitemap generation for GitHub Pages
- 🔗 Internal link validation
- 📱 Responsive design
- ♿ Accessibility-focused
/
├── public/ # Static files copied as-is
├── src/
│ ├── assets/ # Optimized local images
│ ├── content/ # Markdown content files
│ └── pages/ # Astro pages and routes
├── scripts/ # Build and utility scripts
└── package.json
All commands are run from the root of the project:
This project targets Node.js 22.12.0 or newer.
If you use nvm, run nvm use before installing dependencies or running Astro commands.
| Command | Action |
|---|---|
npm install |
Install dependencies |
npm run dev |
Start local dev server at localhost:4321 |
npm run build |
Build the production site to ./dist/ |
npm run preview |
Preview the build locally |
npm run check |
Run Astro content/type checks |
npm run check:links |
Check internal links in generated HTML |
With .nvmrc present, nvm use will select the expected local Node version automatically.
Deployed via GitHub Pages at https://dosorio79.github.io/portfolio/.
The current released version is v0.1.2.
Code is licensed under the MIT License. Content is licensed under
Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International.
See LICENSE and CONTENT_LICENSE.md.