A minimal, responsive Astro portfolio prepared for deployment to GitHub Pages at:
https://twang736.github.io
Install a currently supported Node.js LTS release, Git, and a code editor such as VS Code.
Verify:
node --version
npm --version
git --versionnpm install
npm run devOpen the local URL printed in the terminal, usually http://localhost:4321.
Most text is in:
src/pages/index.astro
Most appearance settings are in:
src/styles/global.css
Site-wide metadata is in:
src/layouts/Layout.astroastro.config.mjs
npm run build
npm run previewCreate a public GitHub repository named exactly:
twang736.github.io
Then run inside this folder:
git init
git add .
git commit -m "Build personal website"
git branch -M main
git remote add origin https://github.com/twang736/twang736.github.io.git
git push -u origin mainOn GitHub, open:
Settings → Pages → Build and deployment → Source → GitHub Actions
The included workflow at .github/workflows/deploy.yml will build and deploy the site on every push to main.
After editing files:
git add .
git commit -m "Update portfolio content"
git pushGitHub Actions will redeploy automatically.
- Replace the “Next Project” placeholder.
- Add verified project links.
- Add a PDF resume to
public/resume.pdf, then add a link to/resume.pdf. - Add LinkedIn only after confirming the exact public profile URL.
- Consider a custom domain after the GitHub Pages URL is working.