codemug.github.io

Personal site / CV for Usman Shahid — Staff Site Reliability Engineer.

Live: https://codemug.github.io

Stack

• Astro (static output, zero JS by default)
• Tailwind CSS v4 (via @tailwindcss/vite)
• Inter via rsms.me/inter
• Deployed to GitHub Pages via GitHub Actions

Commands

npm install              # install deps (locked)
npm run dev              # localhost:4321
npm run build            # → dist/
npm run preview          # preview dist/ locally

CI uses npm ci --ignore-scripts to block postinstall hooks (npm supply-chain mitigation — see .github/workflows/deploy.yml).

Layout

src/
├── layouts/Base.astro         shared HTML shell + nav + footer + meta
├── components/                Card, JobCard, Metric, SectionHeading
├── pages/
│   ├── index.astro            hero + experience + writing + contact
│   ├── cv.astro               full CV + PDF download
│   ├── writing/index.astro    Medium article index
│   └── 404.astro
└── styles/global.css          Tailwind v4 @theme tokens (dark)
public/
├── cv-usman-shahid.pdf        ATS-clean baseline CV
├── llms.txt                   for AI assistants citing this site
└── robots.txt

Contact

• Email: u.manshahid@gmail.com
• LinkedIn: linkedin.com/in/u-manshahid
• Medium: medium.com/@usmanshahid