feat: scaffold certforge static site

Author: gobinathm

.github/workflows/deploy.yml

@@ -0,0 +1,49 @@
+name: Test & Deploy
+
+on:
+  push:
+    branches: ["main"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Test and build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Run tests
+        run: npm test
+      - name: Build site
+        run: npm run build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deploy
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,10 @@
+.DS_Store
+node_modules
+dist
+.astro
+coverage
+.env
+.env.*
+npm-debug.log*
+pnpm-lock.yaml
+yarn.lock

.husky/_/husky.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env sh
+# shellcheck shell=sh
+
+if [ -z "$husky_skip_init" ]; then
+  husky_skip_init=1
+
+  export PATH="${PATH}:./node_modules/.bin"
+fi

.husky/pre-commit

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+echo "Running test suite before commit..."
+npm test

README.md

@@ -0,0 +1,64 @@
+# CertForge Static Site
+
+A lightweight Astro site that showcases every CertForge certification domain, links to the open-source prep repositories, and highlights the hands-on demos that live inside each repo. The site is optimized for GitHub Pages or Cloudflare Pages and enforces tests locally and in CI before deployments run.
+
+## Tech Stack
+
+- [Astro](https://astro.build) for the static site
+- TypeScript modules for study-track data
+- [Vitest](https://vitest.dev) for data integrity tests
+- [Husky](https://typicode.github.io/husky) git hooks to block commits when tests fail
+- GitHub Actions workflow for test + deploy to Pages
+
+## Getting Started
+
+```bash
+npm install
+npm run dev
+```
+
+The dev server runs on `http://localhost:4321` by default.
+
+## Tests
+
+All commits must pass the Vitest suite (a Husky `pre-commit` hook enforces this).
+
+```bash
+npm test        # one-off
+npm run test:watch
+```
+
+The tests verify that each track’s domain weights total 100%, every repo link resolves to the CertForge org, and that each track exposes labs/scripts for the website to promote.
+
+## Deployment
+
+The workflow in `.github/workflows/deploy.yml` handles:
+
+1. `npm ci`
+2. `npm test`
+3. `npm run build`
+4. Upload + deploy to GitHub Pages
+
+The static build artifacts live in `dist/`. Configure Pages to serve from the GitHub Actions workflow output. The same build directory can be uploaded to Cloudflare Pages if desired.
+
+## Project Structure
+
+```
+├── public/                  # Static assets (logos, favicons)
+├── src/
+│   ├── components/          # Reusable UI blocks (track cards, domains)
+│   ├── data/                # Track/domain metadata used for rendering + tests
+│   ├── layouts/             # Site shell
+│   ├── pages/               # Astro pages
+│   └── styles/              # Global CSS
+├── tests/                   # Vitest suites
+└── .husky/                  # Git hooks (pre-commit triggers npm test)
+```
+
+## Contributing
+
+1. Create a branch: `git checkout -b feat/add-track`.
+2. Update the relevant data in `src/data/`.
+3. Run `npm test && npm run lint`.
+4. Commit (the pre-commit hook will re-run `npm test`).
+5. Open a PR describing the update and referencing the source repo.

astro.config.mjs

@@ -0,0 +1,10 @@
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+  site: 'https://certforge.github.io/GITHUB_README',
+  integrations: [],
+  build: {
+    format: 'directory',
+    inlineStylesheets: 'auto'
+  }
+});