Optimize performance, SEO, and accessibility

- Migrate Lucide icons from CDN to npm package (lucide-astro)
- Add lazy loading to images, optimize banner (1.6MB → 100KB)
- Remove 9 unused image files (~2MB)
- Add comprehensive SEO meta tags (Open Graph, Twitter Card, canonical URLs)
- Create robots.txt and sitemap.xml
- Improve accessibility (aria-labels, aria-expanded attributes)
- Rewrite README with technical documentation
- Remove production console.log statements

Author: GreenFlux

README.md

@@ -1,43 +1,122 @@
-# Astro Starter Kit: Minimal
+# GreenFlux Portfolio
 
-```sh
-npm create astro@latest -- --template minimal
-```
+Portfolio website for GreenFlux, LLC (Joseph Petty) built with Astro 5 and Tailwind CSS v4.
+
+**Live Site**: https://greenflux.github.io
 
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+## Technical Stack
 
-## 🚀 Project Structure
+- **Framework**: Astro 5 (Static Site Generation)
+- **Styling**: Tailwind CSS v4 (via Vite plugin)
+- **Icons**: lucide-astro
+- **Deployment**: GitHub Pages via GitHub Actions
+- **View Transitions**: Enabled globally for smooth navigation
 
-Inside of your Astro project, you'll see the following folders and files:
+## Project Structure
 
-```text
+```
 /
 ├── public/
+│   ├── images/            # Static images
+│   ├── robots.txt         # Search engine directives
+│   ├── sitemap.xml        # Site structure for SEO
+│   └── favicon.svg        # Site icon
 ├── src/
-│   └── pages/
-│       └── index.astro
+│   ├── components/        # Astro components
+│   │   ├── Navigation.astro
+│   │   ├── Hero.astro
+│   │   ├── Portfolio.astro
+│   │   ├── About.astro
+│   │   ├── Social.astro
+│   │   └── Footer.astro
+│   ├── data/              # Content data (JSON)
+│   │   ├── portfolio.json # Portfolio items with metadata
+│   │   └── site.json      # Site-wide content
+│   ├── layouts/
+│   │   └── Layout.astro   # Base layout with SEO meta tags
+│   ├── pages/
+│   │   ├── index.astro    # Main landing page
+│   │   └── portfolio/     # Portfolio detail pages
+│   └── styles/
+│       └── global.css     # Global styles and CSS variables
+├── astro.config.mjs       # Astro configuration
+├── tailwind.config.mjs    # Tailwind configuration
+├── CLAUDE.md              # Claude Code context file
 └── package.json
 ```
 
-Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+## Data-Driven Architecture
+
+All content is separated from layout and stored in JSON files:
+
+- `src/data/portfolio.json` - Portfolio project items
+- `src/data/site.json` - Site-wide content (about, social links, company info)
+
+To add or modify content, edit these JSON files rather than modifying components.
+
+## Development Commands
+
+```bash
+npm install              # Install dependencies
+npm run dev             # Start dev server (http://localhost:4321)
+npm run build           # Build for production (outputs to dist/)
+npm run preview         # Preview production build locally
+```
+
+## Deployment
 
-There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+Automatic deployment via GitHub Actions on push to `main` branch:
 
-Any static assets, like images, can be placed in the `public/` directory.
+1. Workflow runs `npm run build`
+2. Deploys `dist/` folder to GitHub Pages
+3. Site available at https://greenflux.github.io
 
-## 🧞 Commands
+Workflow configuration: `.github/workflows/deploy.yml`
 
-All commands are run from the root of the project, from a terminal:
+## Color Theme
+
+Dark theme with green accents:
+
+```css
+--color-dark: #0a0a0a           /* Primary background */
+--color-darker: #000000          /* Darker sections */
+--color-green-primary: #00d600   /* Primary green accent */
+--color-green-bright: #00ff00    /* Bright green hover */
+--color-text-primary: #ffffff    /* White text */
+--color-text-secondary: #a0a0a0  /* Gray text */
+```
+
+## SEO Optimization
+
+- Open Graph meta tags for social media sharing
+- Twitter Card meta tags
+- Canonical URLs
+- robots.txt for search engine crawlers
+- sitemap.xml for search indexing
+- Optimized images with lazy loading
+- Semantic HTML structure
+
+## Adding Portfolio Items
+
+Edit `src/data/portfolio.json` and add a new object to the `items` array:
+
+```json
+{
+  "id": "unique-id",
+  "title": "Project Title",
+  "path": "/portfolio/project-slug",
+  "description": "Project description",
+  "image": "/images/project.png",
+  "tags": ["JavaScript", "API"]
+}
+```
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+For external links, use full URLs in `path`. For internal detail pages, create a new file in `src/pages/portfolio/`.
 
-## 👀 Want to learn more?
+## Performance Optimizations
 
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+- Lazy loading for below-the-fold images
+- Eager loading with fetchpriority="high" for critical images (logo, hero)
+- npm-based icon library (lucide-astro) instead of CDN
+- Optimized image formats and sizes
+- Minimal JavaScript footprint

package-lock.json

@@ -11,6 +11,7 @@
   "dependencies": {
     "@tailwindcss/vite": "^4.1.16",
     "astro": "^5.15.3",
+    "lucide-astro": "^0.552.0",
     "tailwindcss": "^4.1.16"
   }
 }