Hello World: Why This Developer Built a Portfolio with VuePress and GitHub Pages

Hello World

Albertto Castro launched a professional portfolio and blog built with VuePress. The site is deployed as static files on GitHub Pages, with no custom backend code.

Why This Matters

Many developers rely on complex backend stacks (e.g., Node.js, Django) for personal sites, leading to over-engineering, higher maintenance costs, and slower iteration. Castro demonstrates that a static site generator like VuePress, combined with GitHub Pages, can deliver a fully functional portfolio and knowledge base with zero backend overhead, making it accessible for developers of all skill levels.

Key Insights

• Castro uses VuePress to convert markdown files into HTML, JS, and CSS for his portfolio site (2026).
• GitHub Pages hosts the static files, eliminating the need for server-side code (e.g., no backend-running Node.js).
• The site serves dual purposes: professional portfolio and personal knowledge base/reference.
• Open-source repositories are linked for readers to inspect the code under the hood.
• The blog encourages community feedback, disagreement, and suggestions—no absolute truths.
• Model: static site generator (SSG) like VuePress is used by VitePress, Next.js, and others for fast, low-cost deployments.

Practical Applications

• Use case: A junior developer builds a portfolio site with VuePress and GitHub Pages for zero-cost hosting and easy maintenance. Pitfall: Over-customizing the default theme can bloat CSS and increase page load time, harming SEO.
• Use case: A technical writer uses VuePress to create a knowledge base with version-controlled markdown. Pitfall: Not setting up a CI/CD pipeline can lead to manual rebuilds and broken links after updates.

References:

• https://dev.to/alberttocastro/hello-world-3i20