Personal website and blog built with Astro. Minimal, fast, and almost entirely HTML & CSS with zero-JS by default.

Live: avinal.space

• jay.fish — homepage layout, activity graph, bento grid
• usememos.com — clean typography, color palette, overall theme

• Node.js 22+
• npm

git clone https://github.com/avinal/avinal.github.io.git
cd avinal.github.io
make install

No environment variables are required. All external data is fetched from public APIs:

• GitHub — contributions graph and user info (public API)
• WakaTime — coding stats via public share URL
• ListenBrainz — music listening activity (public API, username in src/config/theme.ts)
• Cal.com — meeting booking (embedded via CDN)

make dev        # Start dev server with hot reload
make build      # Build for production
make preview    # Preview production build locally
make check      # Run Astro type checking
make clean      # Remove build artifacts
make nuke       # Full clean (includes node_modules)
make fresh      # Clean install from scratch

src/
├── components/     # Reusable Astro components
├── config/         # Theme tokens and site config
├── content/posts/  # Blog posts (Markdown)
├── data/           # JSON data (resume, repos, events)
├── layouts/        # Page layouts
├── lib/            # Utilities and rehype plugins
├── pages/          # Route pages
└── styles/         # Global CSS
public/             # Static assets (images, favicons)

• Theme & colors: src/config/theme.ts — single file for all design tokens, easily swap the entire color palette
• Repos: src/data/repos.json — pinned repositories shown on the homepage
• Resume: src/data/resume.json — JSON Resume format, drives the /resume/ page

The site is deployed via Netlify. Any push to main triggers a build automatically. See netlify.toml for the build config.

See LICENSE for details.