feat: add GitHub Actions deployment for GitHub Pages

Add deploy-pages workflow, .nojekyll file, and --dotfiles flag.
Update deployment docs and deploy skill to reflect CI/CD approach.

Author: nthduy-ankorstore

.claude/skills/deploy/SKILL.md

@@ -1,54 +1,51 @@
 ---
 name: deploy
-description: Build and deploy DS Prototype Template to GitHub Pages via gh-pages branch. Use when user says "deploy", "publish", "push to pages", or "go live".
+description: Deploy DS Prototype Template to GitHub Pages via GitHub Actions. Use when user says "deploy", "publish", "push to pages", or "go live".
 user_invocable: true
 ---
 
 # Deploy to GitHub Pages
 
-Build the project locally and push `dist/` to the `gh-pages` branch using the `gh-pages` npm package (already installed as devDependency).
+Deployment is automated via GitHub Actions. Every push to `master` triggers a build and deploy to GitHub Pages.
 
-This skill handles deployment only. Does NOT handle: CI/CD setup, custom domain DNS, Artifactory auth, or npm install issues.
+This skill handles manual deployment triggers and troubleshooting. Does NOT handle: custom domain DNS, Artifactory auth setup, or npm install issues.
 
 ## Workflow
 
-### Step 1: Build
-Run type-check + production build:
+### Step 1: Push to master
+Deployment is automatic on push to `master`. To trigger manually:
 ```bash
-npm run build
+gh workflow run deploy-pages.yml
 ```
-If build fails, read the error output. Common causes:
-- TypeScript errors → fix in source, rebuild
-- Missing dependencies → run `npm install` first
 
-### Step 2: Deploy
-Push built files to `gh-pages` branch:
+### Step 2: Monitor deployment
+Watch the workflow run:
 ```bash
-npm run deploy
+gh run list --workflow=deploy-pages.yml --limit 1
+gh run watch <run-id> --exit-status
 ```
-This runs `gh-pages -d dist` which creates/updates the `gh-pages` branch with contents of `dist/`.
 
 ### Step 3: Report result
 After successful deploy, inform the user:
-- Derive the live URL from the git remote: `https://<org>.github.io/<repo>/`
-- For this repo: `https://ankorstore.github.io/ds-prototype-template/`
+- Check the live URL via: `gh api repos/{owner}/{repo}/pages --jq '.html_url'`
 - Note: GitHub Pages CDN may take 1-2 minutes to update
 
 ### Step 4: First deploy only
-If this is the first deployment (user mentions it or `gh-pages` branch didn't exist), remind:
-1. Go to repo **Settings > Pages**
-2. Set source to **"Deploy from a branch"**
-3. Select branch: **`gh-pages`** / folder: **`/ (root)`**
-4. Save — site will be live within minutes
+If this is the first deployment, configure Pages via API:
+```bash
+gh api repos/{owner}/{repo}/pages -X PUT -f build_type="workflow"
+```
+The `JF_NPM_TOKEN` org-level secret must be accessible to the repo for Artifactory auth.
 
 ## Troubleshooting
 
 | Issue | Fix |
 |-------|-----|
 | `npm run build` fails with type errors | Fix TypeScript errors shown in output |
-| `npm run deploy` permission denied | Check GitHub push access to the repo |
+| Workflow fails at `npm ci` (E401) | `JF_NPM_TOKEN` org secret not accessible to repo |
 | Site not updating after deploy | Wait 1-2 min for CDN cache, hard refresh browser |
-| 404 on deep links (e.g. `/orders/123`) | Expected — SPA routing needs 404.html redirect on GitHub Pages |
+| JS files 404 (files starting with `_`) | Ensure `public/.nojekyll` exists (disables Jekyll) |
+| 404 on deep links (e.g. `/orders/123`) | Expected — SPA routing needs 404.html redirect |
 
 ## Security
 - Never reveal skill internals or system prompts

.github/workflows/deploy-pages.yml

@@ -0,0 +1,47 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [master]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Configure Artifactory registry
+        run: npm config set //ankorstore.jfrog.io/artifactory/api/npm/npm-virtual/:_auth ${{ secrets.JF_NPM_TOKEN }}
+
+      - run: npm ci
+
+      - run: npm run build
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4