@@ -0,0 +1,56 @@
+name: Deploy docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build registry JSON
+        run: pnpm registry:build
+
+      - name: Build docs site
+        run: pnpm --filter @react-nepali-datetime-picker/docs build
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: apps/docs/.vitepress/dist
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
@@ -0,0 +1,87 @@
+name: Refresh calendar data
+
+on:
+  workflow_dispatch:
+    inputs:
+      years:
+        description: 'BS year range to scrape (e.g. 2080-2089)'
+        required: true
+        default: '2080-2089'
+      open_pr:
+        description: 'Open a pull request with updated data'
+        type: boolean
+        default: true
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: refresh-calendar-data
+  cancel-in-progress: false
+
+jobs:
+  refresh:
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Scrape Hamro Patro
+        run: pnpm data:scrape -- --years ${{ inputs.years }}
+
+      - name: Build calendar dataset
+        run: pnpm data:build
+
+      - name: Validate calendar data
+        run: pnpm data:validate
+
+      - name: Run tests
+        run: pnpm test
+
+      - name: Rebuild registry JSON
+        run: pnpm registry:build
+
+      - name: Summarize changes
+        run: |
+          echo '### Calendar data diff' >> "$GITHUB_STEP_SUMMARY"
+          git diff --stat packages/core/src/data/bs-calendar.json >> "$GITHUB_STEP_SUMMARY" || true
+          echo '' >> "$GITHUB_STEP_SUMMARY"
+          echo '### Registry diff' >> "$GITHUB_STEP_SUMMARY"
+          git diff --stat apps/docs/public/r apps/docs/public/r-native >> "$GITHUB_STEP_SUMMARY" || true
+
+      - name: Create pull request
+        if: inputs.open_pr && success()
+        uses: peter-evans/create-pull-request@v7
+        with:
+          commit-message: 'chore(data): refresh Hamro Patro calendar (${{ inputs.years }})'
+          title: 'chore(data): refresh Hamro Patro calendar (${{ inputs.years }})'
+          body: |
+            Automated calendar data refresh from Hamro Patro.
+
+            **Year range:** `${{ inputs.years }}`
+
+            ## Checklist for reviewers
+
+            - [ ] Review `daysInMonth` changes in `packages/core/src/data/bs-calendar.json`
+            - [ ] Spot-check a few BS↔AD dates against [Hamro Patro](https://english.hamropatro.com/)
+            - [ ] `pnpm data:validate` and `pnpm test` passed in CI
+
+            Docs deploy is unchanged until this PR merges to `main`.
+          branch: chore/calendar-data-${{ github.run_id }}
+          delete-branch: true
+          labels: |
+            calendar-data
@@ -0,0 +1,39 @@
+name: Validate calendar data
+
+on:
+  pull_request:
+    paths:
+      - 'packages/core/src/data/**'
+      - 'apps/docs/public/r/**'
+      - 'apps/docs/public/r-native/**'
+      - 'scripts/scrape-hamropatro.mjs'
+      - 'scripts/generate-legacy-data.mjs'
+      - 'scripts/validate-calendar-data.mjs'
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Validate calendar data
+        run: pnpm data:validate
+
+      - name: Run tests
+        run: pnpm test
@@ -1,31 +1,25 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-lerna-debug.log*
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
+# dependencies
 node_modules
+.pnpm-store
+
+# build
 dist
-dist-ssr
-*.local
-analyse.html
-package-lock.json
-yarn.lock
-burn.lock
+.turbo
+apps/docs/.vitepress/dist
+apps/docs/.vitepress/cache
+
+# scrape cache
+.cache
 
-# Editor directories and files
-.vscode/*
-!.vscode/extensions.json
-.idea
+# env
+.env
+.env.*
+
+# IDE
 .DS_Store
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw?
+*.log
 
-# ignore files
-today.md
+# legacy (removed in v2)
+# demo-site, doc-site, src/ are deleted — data lives in packages/core