Personal portal

A static personal site built with Astro: about on the home page, plus resume and a Markdown blog. Meant for GitHub Pages.

Local development

npm install
npm run dev

Open the URL the CLI prints (default http://localhost:4321).

npm run build
npm run preview

Replace the sample content

1. Edit src/data/site.ts: name, title, about, skills, experience, education, projects, and social links.
2. Replace the samples in src/content/blog/ with your own posts. Set draft: true in the frontmatter to hide a post.
3. To offer a resume PDF, put the file at public/resume.pdf and set site.resumePdf to "/resume.pdf".
4. To preview a project-site path locally:

PUBLIC_BASE_PATH=/personal_web/ npm run dev

Deploy to GitHub Pages

1. Push this project to GitHub on the main branch.
2. In the repo, open Settings → Pages → Build and deployment and choose GitHub Actions.
3. After each push, .github/workflows/deploy.yml builds and publishes the site.

The workflow sets the path from the repository name:

Repository name	URL	base
username.github.io	https://username.github.io/	/
Anything else (e.g. personal_web)	https://username.github.io/personal_web/	/personal_web/

Locally, base defaults to /. To override it, set PUBLIC_SITE_URL and PUBLIC_BASE_PATH (see astro.config.mjs).

Stack

• Astro 5 (static output)
• Tailwind CSS 4
• Content Collections (Markdown posts)