Next js migration

.github/FIRST_TIMER_GUIDE.md

@@ -0,0 +1,11 @@
+### Welcome, and thanks for taking this issue
+
+- Setup: install dependencies and confirm local build/test commands run successfully.
+- Run locally: use the project run/dev script from `package.json`.
+- Lint and test before pushing.
+- Branch naming: use a focused branch like `fix/issue-<number>-short-summary` or `feat/issue-<number>-short-summary`.
+- Commit messages: keep them concise and imperative (example: `fix(ui): handle empty state`).
+- Open a draft PR early if your approach or scope may need maintainer feedback.
+- Link your PR to the issue using `fixes #<issue-number>` (or `closes` / `resolves`).
+- While active, post `/working` on the issue to signal progress.
+- If blocked or no longer available, post `/unassign` so others can continue.

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,68 @@
+name: 🐛 Bug Report
+description: Report a bug or issue
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: Thanks for reporting a bug! Please fill out the details below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe the bug clearly
+      placeholder: What went wrong?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: How do we reproduce the issue?
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. See the error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should happen?
+      placeholder: describe expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Browser, OS, Node version, or other relevant info
+      placeholder: |
+        - OS: macOS 14.1
+        - Browser: Chrome 120
+        - Node: 20.10
+    validations:
+      required: false
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error Logs or Screenshots
+      description: Paste any error messages or attach screenshots
+      placeholder: Errors, stack traces, or screenshots
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues
+          required: true
+        - label: I have provided a clear description
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://github.com/orgs/open-elements/discussions
+    about: Questions about usage or architecture

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,53 @@
+name: ✨ Feature Request
+description: Suggest an idea or enhancement
+labels: ["enhancement", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: We'd love to hear your ideas! Please describe the feature you'd like to see.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: Describe the problem or use case
+      placeholder: "Is your request related to a problem? Ex. I'm frustrated when..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like
+      placeholder: How should this feature work?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Other options you've explored
+      placeholder: Any other approaches?
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other relevant information
+      placeholder: Screenshots, examples, links, etc.
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues and discussions
+          required: true
+        - label: This request aligns with project goals
+          required: false

.github/pull_request_template.md

@@ -0,0 +1,35 @@
+## Description
+Brief description of changes made in this PR.
+
+## Type of Change
+- [ ] 🐛 Bug fix
+- [ ] ✨ New feature
+- [ ] 📝 Documentation update
+- [ ] 🎨 Style/formatting
+- [ ] ♻️ Refactor
+- [ ] 🔧 Configuration
+- [ ] ⚡ Performance
+- [ ] 🧪 Tests
+- [ ] 🔐 Security
+
+## Related Issue(s)
+Closes #ISSUE_NUMBER
+
+## Changes Made
+- Change 1
+- Change 2
+- Change 3
+
+## How to Test
+1. Step 1
+2. Step 2
+3. Verify the expected behavior
+
+## Checklist
+- [ ] Code follows project style guidelines
+- [ ] Self-review conducted
+- [ ] Comments added for complex logic
+- [ ] Documentation updated (if needed)
+- [ ] No new warnings generated
+- [ ] Tests added/updated (if applicable)
+- [ ] All tests passing locally

.github/reviewers.json

@@ -0,0 +1,35 @@
+{
+  "default_reviewers": [],
+  "path_reviewers": [
+    {
+      "glob": "/**",
+      "reviewers": [
+        "danielmarv",
+        "hendrikebbers",
+        "Jexsie",
+        "sebtiem",
+        "Ndacyayisenga-droid"
+      ]
+    },
+    {
+      "glob": ".github/**",
+      "reviewers": [
+        "danielmarv",
+        "hendrikebbers",
+        "Jexsie",
+        "sebtiem",
+        "Ndacyayisenga-droid"
+      ]
+    },
+    {
+      "glob": "docs/**",
+      "reviewers": [
+        "danielmarv",
+        "hendrikebbers",
+        "Jexsie",
+        "sebtiem",
+        "Ndacyayisenga-droid"
+      ]
+    }
+  ]
+}

.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  workflow_dispatch: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@58077d3c7e43986b6b15fba718e8ea69e387dfcc # v2.15.1
+        with:
+          egress-policy: audit
+
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Node.js
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        with:
+          node-version: 20
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v4.4.0
+        with:
+          version: 10
+          run_install: false
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - name: Setup pnpm cache
+        uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
+        with:
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run lint check
+        run: pnpm lint
+
+      - name: Build Next.js application
+        run: pnpm build
+        env:
+          NEXT_TELEMETRY_DISABLED: 1

.github/workflows/e2e-tests.yml

@@ -0,0 +1,64 @@
+name: E2E Tests
+
+on:
+  push:
+    branches: [main, next-js-migration]
+  pull_request:
+    branches: [main, next-js-migration]
+
+jobs:
+  test:
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Install Playwright browsers
+        run: pnpm exec playwright install --with-deps chromium
+
+      - name: Run E2E tests
+        run: pnpm test:e2e
+
+      - name: Upload test results
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 7
+
+      - name: Upload test traces
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-traces
+          path: test-results/
+          retention-days: 7