feat: redesign my webiste from scratch

- remove hugo and paper box theme
- inspiration https://jay.fish
- use astro based system

Signed-off-by: Avinal Kumar <avinal.xlvii@gmail.com>

README.md

@@ -1,2 +1,87 @@
-# My Personal Website and Blog
+# avinal.space
 
+Personal website and blog built with [Astro](https://astro.build). Minimal, fast, and almost entirely HTML & CSS with zero-JS by default.
+
+**Live:** [avinal.space](https://avinal.space)
+
+## Design Inspiration
+
+- [jay.fish](https://jay.fish/) — homepage layout, activity graph, bento grid
+- [usememos.com](https://usememos.com/) — clean typography, color palette, overall theme
+
+## Pages
+
+| Route | Description |
+|-------|-------------|
+| `/` | Homepage with hero card, GitHub/WakaTime activity graph, Game of Life widget, recent posts, and pinned repos |
+| `/posts/` | Blog index with category filters and featured images |
+| `/posts/<category>/` | Category-filtered post listings |
+| `/posts/<category>/<slug>/` | Individual blog posts |
+| `/resume/` | Resume page (data driven from `src/data/resume.json`) |
+| `/meeting/` | Book a meeting via [Cal.com](https://cal.com) embed |
+| `/setup/` | Hardware and software setup |
+| `/rss.xml` | RSS feed |
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/) 22+
+- npm
+
+## Getting Started
+
+```bash
+git clone https://github.com/avinal/avinal.github.io.git
+cd avinal.github.io
+make install
+```
+
+Copy the example env file and add your keys:
+
+```bash
+cp .env.example .env
+```
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `WAKATIME_API_KEY` | No | Enables WakaTime coding stats on the homepage activity graph. Get yours at [wakatime.com/settings/api-key](https://wakatime.com/settings/api-key) |
+
+## Development
+
+```bash
+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
+```
+
+## Project Structure
+
+```
+src/
+├── components/     # Reusable Astro components
+├── config/         # Theme tokens and site config
+├── content/posts/  # Blog posts (Markdown)
+├── data/           # JSON data (resume, repos)
+├── layouts/        # Page layouts
+├── lib/            # Utilities and rehype plugins
+├── pages/          # Route pages
+└── styles/         # Global CSS
+public/             # Static assets (images, favicons)
+```
+
+## Configuration
+
+- **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
+
+## Deployment
+
+The site is deployed via [Netlify](https://netlify.com). Any push to `main` triggers a build automatically. See `netlify.toml` for the build config.
+
+## License
+
+See [LICENSE](LICENSE) for details.