diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..7c8986e
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,13 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 0000000..56ee2a0
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1,2 @@
+# Default owners for all files
+* @hellopaywaz
diff --git a/.github/workflows/docs-ci.yml b/.github/workflows/docs-ci.yml
index 9b3e1de..66dcb23 100644
--- a/.github/workflows/docs-ci.yml
+++ b/.github/workflows/docs-ci.yml
@@ -4,16 +4,24 @@ on:
   push:
     branches: [main]
 
+permissions:
+  contents: read
+
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
-      - name: Generate API docs
-        run: |
-          npx redoc-cli build openapi/openapi.yaml \
-            --output docs/api/reference.html
-
-      - name: Deploy Docs
-        run: echo "Deploy step here (Pages / Cloudflare / etc)"
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Build static docs
+        run: npm run build
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: paywaz-docs-dist
+          path: dist
diff --git a/.github/workflows/node-ci.yml b/.github/workflows/node-ci.yml
index 6270573..d0a1361 100644
--- a/.github/workflows/node-ci.yml
+++ b/.github/workflows/node-ci.yml
@@ -6,6 +6,9 @@ on:
   pull_request:
     branches: [ main ]
 
+permissions:
+  contents: read
+
 jobs:
   ci:
     runs-on: ubuntu-latest
@@ -24,25 +27,13 @@ jobs:
         run: npm ci
 
       - name: Lint
-        run: |
-          if npm run | grep -q "lint"; then
-            npm run lint
-          else
-            echo "No lint script – skipping"
-          fi
+        run: npm run lint
+
+      - name: Typecheck
+        run: npm run typecheck
 
       - name: Test
-        run: |
-          if npm run | grep -q "test"; then
-            npm test
-          else
-            echo "No test script – skipping"
-          fi
+        run: npm test
 
       - name: Build
-        run: |
-          if npm run | grep -q "build"; then
-            npm run build
-          else
-            echo "No build script – skipping"
-          fi
+        run: npm run build
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..d2af23e
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,9 @@
+node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.DS_Store
+.dist
+/dist
+.env*
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 16f8cf4..ea2d6eb 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,7 +1,7 @@
 # Contributing to Paywaz
 
-First off — thank you for your interest in contributing to Paywaz!  
-Our ecosystem powers **zero-fee payments**, **stablecoin infrastructure**, and **developer-first APIs/SDKs**.  
+First off — thank you for your interest in contributing to Paywaz!
+Our ecosystem powers **zero-fee payments**, **stablecoin infrastructure**, and **developer-first APIs/SDKs**.
 We welcome improvements, bug fixes, documentation updates, and new sample integrations.
 
 This document explains how to contribute and what we expect from contributors.
@@ -10,11 +10,11 @@ This document explains how to contribute and what we expect from contributors.
 
 ## Ways You Can Contribute
 
-- Report bugs or issues  
-- Suggest features or improvements  
-- Submit pull requests for fixes or enhancements  
-- Improve documentation  
-- Add sample integrations or SDK upgrades  
+- Report bugs or issues
+- Suggest features or improvements
+- Submit pull requests for fixes or enhancements
+- Improve documentation
+- Add sample integrations or SDK upgrades
 - Improve developer experience (DX), tooling, or testing
 
 ---
@@ -23,11 +23,11 @@ This document explains how to contribute and what we expect from contributors.
 
 We maintain several public repos:
 
-- `paywaz-public-api` — API schemas, references, and public interface definitions  
-- `paywaz-sdk-js` — JavaScript/TypeScript SDK  
-- `paywaz-docs` — developer documentation and guides  
-- `paywaz-samples` — integration samples  
-- `paywaz-license` — licensing information  
+- `paywaz-public-api` — API schemas, references, and public interface definitions
+- `paywaz-sdk-js` — JavaScript/TypeScript SDK
+- `paywaz-docs` — developer documentation and guides
+- `paywaz-samples` — integration samples
+- `paywaz-license` — licensing information
 
 Each repo may have repo-specific instructions in its README.
 
@@ -35,35 +35,35 @@ Each repo may have repo-specific instructions in its README.
 
 ## Development Workflow
 
-### 1. Fork the repo  
+### 1. Fork the repo
 Click **Fork** in the top-right corner of the GitHub repo.
 
-### 2. Create a feature branch  
+### 2. Create a feature branch
 
 git checkout -b feature/your-feature-name
 
-### 3. Make your changes  
+### 3. Make your changes
 Please follow:
-- existing code style  
-- naming conventions  
-- project folder structure  
+- existing code style
+- naming conventions
+- project folder structure
 - TypeScript / JS linting rules (if applicable)
 
-### 4. Write tests (if applicable)  
+### 4. Write tests (if applicable)
 PRs without tests may not be accepted for core SDK repos.
 
-### 5. Commit with clear messages  
+### 5. Commit with clear messages
 
 git commit -m "feat: add X"
 git commit -m "fix: correct Y"
 git commit -m "docs: improve Z"
 
-### 6. Submit your Pull Request  
+### 6. Submit your Pull Request
 Ensure your PR includes:
-- A clear explanation of the change  
-- Linked issue numbers  
-- Steps to reproduce or test  
-- Any screenshots if UI or docs-related  
+- A clear explanation of the change
+- Linked issue numbers
+- Steps to reproduce or test
+- Any screenshots if UI or docs-related
 
 The Paywaz team will review your PR and may request revisions.
 
@@ -72,33 +72,33 @@ The Paywaz team will review your PR and may request revisions.
 ## Testing & Quality
 
 SDK repos require:
-- Unit tests  
-- Linting  
-- Type definitions  
+- Unit tests
+- Linting
+- Type definitions
 
 Docs repos require:
-- No broken links  
-- Accurate descriptions  
-- Proper formatting and structure  
+- No broken links
+- Accurate descriptions
+- Proper formatting and structure
 
 Samples repos require:
-- Clear README per sample  
-- Minimal dependencies  
+- Clear README per sample
+- Minimal dependencies
 - Secure handling of API keys
 
 ---
 
 ## Licensing Agreement
 
-By submitting a pull request, you agree that your contributions fall under the **Paywaz License** contained in:  
+By submitting a pull request, you agree that your contributions fall under the **Paywaz License** contained in:
 https://github.com/hellopaywaz/paywaz-license
 
 ---
 
 ## Questions? Need help?
 
-Open a discussion or issue, or reach out at:  
+Open a discussion or issue, or reach out at:
 **hello@paywaz.com**
 
-Thank you again for contributing to the Paywaz ecosystem!  
+Thank you again for contributing to the Paywaz ecosystem!
 Your improvements help power the next generation of zero-fee global payments.
diff --git a/HEALTH.md b/HEALTH.md
new file mode 100644
index 0000000..278b93d
--- /dev/null
+++ b/HEALTH.md
@@ -0,0 +1,49 @@
+# Repository Health Audit
+
+**Overall score:** 68/100 — Static documentation hub with minimal build/test coverage now wired into CI. Core hygiene files exist, but automated security/release/deploy practices are light.
+
+**Subscores**
+- CI/Build Reproducibility (25): 20 — Node 20 pinned; lint/test/build scripted; CI caches npm and runs on push/PR. No scheduled runs or matrix coverage.
+- Tests/Quality Gates (20): 12 — Smoke test validates landing page and links; lint covers whitespace/title checks. No deeper content validation or regression tests.
+- Security Baseline (20): 13 — SECURITY.md present and CI permissions narrowed to read; proprietary license documented. Missing secret/dependency scanning and SBOM generation.
+- Release/Packaging (15): 9 — Build script produces static `dist/`, but no automated publish/release cadence or changelog/tagging.
+- Documentation/Onboarding (10): 8 — README now documents golden commands and local serving; CONTRIBUTING and CODE_OF_CONDUCT present.
+- Ops/Runbooks/Observability (10): 6 — Static site only; no deploy/runbook, monitoring, or uptime checks noted.
+
+## P0 blockers
+- None identified after adding build/test scripts, CI coverage, and baseline governance files.
+
+## P1 risks
+- No automated dependency or secret scanning (e.g., Dependabot, secret scanning, npm audit) to catch supply-chain issues early.
+- Docs build relies on external OpenAPI URL without availability guardrails; no caching or checksum verification.
+- No automated deployment pipeline or changelog/versioning for published docs.
+- Typechecking is a placeholder; no schema/HTML validation beyond the smoke test.
+
+## P2 hygiene
+- Add link/HTML validation and accessibility checks to improve doc quality.
+- Add scheduled CI runs to surface drift and external link rot.
+- Consider a static site generator or templating to simplify future expansion and theming.
+- Expand `.gitignore`/tooling as new build artifacts emerge (e.g., screenshots, coverage reports).
+
+## CI status
+- **Node CI** (`.github/workflows/node-ci.yml`): runs on push/PR to `main`; installs dependencies with npm, then runs lint → typecheck (placeholder) → test (smoke) → build.
+- **Build Docs** (`.github/workflows/docs-ci.yml`): runs on push to `main`; installs dependencies, builds `dist/`, and uploads the artifact for distribution.
+
+## Security baseline
+- SECURITY.md defines reporting channel (`security@paywaz.com`).
+- Permissions tightened to `contents: read` for workflows. No secret context required.
+- No dependency scanning, secret scanning, or SBOM generation is enabled yet.
+
+## Release readiness
+- Proprietary license documented in `LICENSE` (mirrors `paywaz-license`).
+- No tagged releases, changelog, or automated publishing of the `dist/` artifact; builds are manual.
+- Package is marked `private` with Node 20+ engine declaration to avoid accidental publication.
+
+## Ops readiness
+- Static docs served via `npm run start`/`npm run preview`; no runtime services or health endpoints.
+- No deployment runbook or monitoring for hosted docs; add if/when a hosting target is configured.
+
+## Repo hygiene
+- Baseline governance files present: README, LICENSE, CODEOWNERS, CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, HEALTH.
+- `.editorconfig` and `.gitignore` added for consistent formatting and artifact hygiene.
+- Golden commands documented in README and enforced in CI.
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..fda0c1a
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,109 @@
+Paywaz Proprietary License Agreement
+Version 1.0 — © 2025 Paywaz.com LLC
+
+IMPORTANT: This software, documentation, or file set (the “Software”) is the
+intellectual property of Paywaz.com LLC (“Paywaz”). By accessing, downloading,
+copying, or using the Software, you agree to the terms of this License.
+
+If you do not agree, you must immediately cease all use of the Software.
+
+---
+
+1. GRANT OF LIMITED RIGHT
+
+Paywaz grants you a limited, revocable, non-exclusive, non-transferable,
+non-sublicensable license to:
+
+(a) View the Software for informational, evaluation, or integration-planning  
+purposes;  
+(b) Use the Software solely for non-commercial internal evaluation;  
+(c) Reference the Software to assess compatibility with your own systems.
+
+No other rights are granted.
+
+---
+
+2. RESTRICTIONS
+
+Except where explicitly permitted in writing by Paywaz, you MAY NOT:
+
+(a) Copy, modify, distribute, publish, or create derivative works of the Software;  
+(b) Use the Software for any commercial activity, paid service, production
+environment, or merchant processing;  
+(c) Reverse engineer, decompile, disassemble, or attempt to derive source logic,
+data models, API behavior, or internal system architecture;  
+(d) Remove, alter, or obscure any Paywaz ownership notices;  
+(e) Redistribute the Software on GitHub or any other platform;  
+(f) Use the Software to build or improve a competing product or service.
+
+Any unauthorized use terminates this License immediately.
+
+---
+
+3. OWNERSHIP
+
+All rights, title, interest, trademarks, trade secrets, and intellectual property
+associated with the Software remain the exclusive property of Paywaz.com LLC.
+
+Nothing in this License transfers or assigns ownership to you.
+
+---
+
+4. NO WARRANTY
+
+The Software is provided “AS IS” with no warranties, express or implied,
+including but not limited to warranties of:
+
+– Merchantability  
+– Fitness for a particular purpose  
+– Accuracy  
+– Availability  
+– Non-infringement  
+
+Paywaz disclaims all liability arising from use of the Software.
+
+---
+
+5. LIMITATION OF LIABILITY
+
+To the maximum extent permitted by law, Paywaz shall not be liable for any:
+
+– Direct, indirect, incidental, special, punitive, or consequential damages  
+– Loss of revenue, profits, data, business opportunity, goodwill  
+– Security breaches, interruptions, or operational impacts  
+
+Use of the Software is entirely at your own risk.
+
+---
+
+6. TERMINATION
+
+Paywaz may revoke this License at any time without notice.  
+Upon termination, you must immediately cease all use and destroy any copies of
+the Software.
+
+---
+
+7. GOVERNING LAW
+
+This License shall be governed by and construed in accordance with the laws of
+the State of Delaware, without regard to conflict-of-law principles.
+
+---
+
+8. CONTACT
+
+For commercial licensing, permissions, or partnership inquiries:
+
+Paywaz.com LLC  
+Email: legal@paywaz.com  
+Website: https://paywaz.com
+
+---
+
+9. ACCEPTANCE
+
+By accessing or using the Software, you acknowledge that you have read,
+understood, and agree to be bound by this License.
+
+© 2025 Paywaz.com LLC — All Rights Reserved.
diff --git a/README.md b/README.md
index 81b8560..fbd8fa6 100644
--- a/README.md
+++ b/README.md
@@ -2,9 +2,9 @@
 
 Welcome to the **Paywaz Documentation Hub**, the central resource for technical, merchant, and architectural documentation related to the Paywaz ecosystem.
 
-> **Important:**  
-> Paywaz is currently operating in **semi-stealth mode**.  
-> All documentation in this repository is a **public preview** intended for early integrators, partners, and candidates.  
+> **Important:**
+> Paywaz is currently operating in **semi-stealth mode**.
+> All documentation in this repository is a **public preview** intended for early integrators, partners, and candidates.
 > Certain systems, flows, and endpoints are intentionally generalized or placeholder-only until public API access is released.
 
 ---
@@ -14,11 +14,11 @@ Welcome to the **Paywaz Documentation Hub**, the central resource for technical,
 This repo is the **single landing hub** for Paywaz developer surface area:
 
 1) **API (OpenAPI)**
-- OpenAPI spec repo: https://github.com/hellopaywaz/paywaz-public-api  
+- OpenAPI spec repo: https://github.com/hellopaywaz/paywaz-public-api
 - Hosted API docs (embedded): https://hellopaywaz.github.io/paywaz-docs/
 
 2) **SDK (JavaScript)**
-- SDK repo: https://github.com/hellopaywaz/paywaz-sdk-js  
+- SDK repo: https://github.com/hellopaywaz/paywaz-sdk-js
 - SDK TypeDoc (GitHub Pages): https://hellopaywaz.github.io/paywaz-sdk-js/
 
 3) **Samples**
@@ -29,6 +29,22 @@ This repo is the **single landing hub** for Paywaz developer surface area:
 
 ---
 
+## Local development & verification
+
+Requirements: **Node.js 20+**. Install dependencies with `npm ci` (no external packages are required).
+
+Golden commands (also used in CI):
+- `npm run lint` — trims trailing whitespace and checks the docs landing page metadata
+- `npm run typecheck` — placeholder until TypeScript sources are added
+- `npm test` — smoke-checks the docs landing page and required links
+- `npm run build` — copies `docs/` to `dist/` for static hosting
+- `npm run start` — serves `docs/` locally at http://localhost:4173
+- `npm run preview` — serves the built `dist/` output at http://localhost:4174
+
+Use `npm run format` to auto-fix common lint issues (trailing whitespace, missing final newline).
+
+---
+
 ## What Is Paywaz?
 
 Paywaz is a zero-fee, crypto-native global payments platform built on next-generation Web3 rails, featuring:
@@ -89,7 +105,7 @@ integration model.
 | **paywaz-sdk-js** | JavaScript SDK (preview) |
 | **paywaz-samples** | Integration examples (JS, Python, cURL) |
 
-Explore more at the Paywaz GitHub organization:  
+Explore more at the Paywaz GitHub organization:
 https://github.com/hellopaywaz
 
 ---
@@ -100,26 +116,26 @@ As Paywaz transitions toward open API access, this repository will grow to
 include:
 
 ### **v0.2**
-- Webhooks and event signatures  
-- Authentication deep-dive  
-- Checkout session flows  
+- Webhooks and event signatures
+- Authentication deep-dive
+- Checkout session flows
 
 ### **v0.3**
-- Error model & retry strategies  
-- POS integration documentation  
-- Workforce payments documentation  
+- Error model & retry strategies
+- POS integration documentation
+- Workforce payments documentation
 
 ### **v0.4**
-- Solana wallet integration guide  
-- Hedged stablecoin mechanics (public-safe version)  
-- Cross-border payment flows  
+- Solana wallet integration guide
+- Hedged stablecoin mechanics (public-safe version)
+- Cross-border payment flows
 
 ### **v1.0 (Public API Launch)**
-- Full API reference  
-- SDK guides (JS, Python, POS)  
-- Merchant dashboard integration docs  
-- Reporting & settlement APIs  
-- Compliance & security documentation  
+- Full API reference
+- SDK guides (JS, Python, POS)
+- Merchant dashboard integration docs
+- Reporting & settlement APIs
+- Compliance & security documentation
 
 ---
 
@@ -128,7 +144,7 @@ include:
 Documentation in this repository is provided under the **Paywaz Proprietary
 License**, unless otherwise noted.
 
-See:  
+See:
 `paywaz-license`
 
 ---
@@ -139,8 +155,8 @@ Public contributions are welcome where appropriate.
 
 Please review:
 
-- `CONTRIBUTING.md`  
-- `CODE_OF_CONDUCT.md`  
+- `CONTRIBUTING.md`
+- `CODE_OF_CONDUCT.md`
 
 Before submitting issues or suggestions.
 
@@ -150,12 +166,11 @@ Before submitting issues or suggestions.
 
 For partnership, integration, or early-access inquiries:
 
-**hello@paywaz.com**  
+**hello@paywaz.com**
 https://paywaz.com
 
 ---
 
-**Paywaz.com LLC — Zero-Fee Crypto-Native Payments Infrastructure**  
+**Paywaz.com LLC — Zero-Fee Crypto-Native Payments Infrastructure**
 Built for global commerce. Powered by the next generation of digital settlement rails.
 
-
diff --git a/SECURITY.md b/SECURITY.md
index 1bd2d30..5e399c1 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -1,6 +1,6 @@
 # Security Policy
 
-Security is a top priority at Paywaz.  
+Security is a top priority at Paywaz.
 If you believe you’ve discovered a vulnerability that could affect Paywaz systems, SDKs, APIs, or documentation, please follow this policy.
 
 ---
@@ -9,12 +9,12 @@ If you believe you’ve discovered a vulnerability that could affect Paywaz syst
 
 This security policy applies to:
 
-- `paywaz-public-api`  
-- `paywaz-sdk-js`  
-- `paywaz-docs`  
-- `paywaz-samples`  
-- `paywaz-license`  
-- Any official Paywaz open-source project or SDK  
+- `paywaz-public-api`
+- `paywaz-sdk-js`
+- `paywaz-docs`
+- `paywaz-samples`
+- `paywaz-license`
+- Any official Paywaz open-source project or SDK
 
 ---
 
@@ -27,11 +27,11 @@ Please email:
 **security@paywaz.com**
 
 Include:
-- Description of the issue  
-- Affected repo(s)  
-- Proof-of-concept if available  
-- Steps to reproduce  
-- Recommended mitigations (optional)  
+- Description of the issue
+- Affected repo(s)
+- Proof-of-concept if available
+- Steps to reproduce
+- Recommended mitigations (optional)
 
 We aim to acknowledge vulnerability reports within **48 hours**, and provide a remediation plan within **5 working days**.
 
@@ -40,9 +40,9 @@ We aim to acknowledge vulnerability reports within **48 hours**, and provide a r
 ## Responsible Disclosure
 
 We request:
-- No public disclosure until our fix is released  
-- No exploitation of the vulnerability  
-- No disruption to Paywaz services or network  
+- No public disclosure until our fix is released
+- No exploitation of the vulnerability
+- No disruption to Paywaz services or network
 
 We appreciate responsible researchers and will credit them (optional) after resolution.
 
@@ -51,10 +51,10 @@ We appreciate responsible researchers and will credit them (optional) after reso
 ## Security Updates
 
 Maintainers will:
-- Prioritize critical vulnerabilities  
-- Patch supported versions  
-- Publish release notes for security fixes  
-- Update documentation as needed  
+- Prioritize critical vulnerabilities
+- Patch supported versions
+- Publish release notes for security fixes
+- Update documentation as needed
 
 ---
 
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 0000000..a910d89
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,16 @@
+{
+  "name": "paywaz-docs",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "paywaz-docs",
+      "version": "1.0.0",
+      "license": "SEE LICENSE IN paywaz-license",
+      "engines": {
+        "node": ">=20"
+      }
+    }
+  }
+}
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..39772f2
--- /dev/null
+++ b/package.json
@@ -0,0 +1,22 @@
+{
+  "name": "paywaz-docs",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Static documentation hub for Paywaz API, SDK, and integration resources.",
+  "license": "SEE LICENSE IN paywaz-license",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "lint": "node scripts/lint.js",
+    "format": "node scripts/lint.js --fix",
+    "typecheck": "node -e \"console.log('No TypeScript sources to type-check yet.')\"",
+    "test": "node scripts/smoke.js",
+    "clean": "rm -rf dist",
+    "build": "npm run clean && node scripts/build.js",
+    "dev": "node scripts/serve.js docs 4173",
+    "start": "node scripts/serve.js docs 4173",
+    "preview": "node scripts/serve.js dist 4174"
+  },
+  "packageManager": "npm@10.9.2"
+}
diff --git a/scripts/build.js b/scripts/build.js
new file mode 100644
index 0000000..56de868
--- /dev/null
+++ b/scripts/build.js
@@ -0,0 +1,33 @@
+const fs = require('fs');
+const path = require('path');
+
+const sourceDir = path.join(__dirname, '..', 'docs');
+const outputDir = path.join(__dirname, '..', 'dist');
+
+if (!fs.existsSync(sourceDir)) {
+  console.error(`Source docs directory not found at: ${sourceDir}`);
+  process.exit(1);
+}
+
+fs.rmSync(outputDir, { recursive: true, force: true });
+fs.mkdirSync(outputDir, { recursive: true });
+
+const copyRecursive = (src, dest) => {
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      fs.mkdirSync(destPath, { recursive: true });
+      copyRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+};
+
+copyRecursive(sourceDir, outputDir);
+
+console.log(`Copied documentation from ${sourceDir} to ${outputDir}`);
diff --git a/scripts/lint.js b/scripts/lint.js
new file mode 100644
index 0000000..fc99c0d
--- /dev/null
+++ b/scripts/lint.js
@@ -0,0 +1,88 @@
+const fs = require('fs');
+const path = require('path');
+
+const fixMode = process.argv.includes('--fix');
+const filesToCheck = [
+  'README.md',
+  'SECURITY.md',
+  'CONTRIBUTING.md',
+  'docs/index.html',
+];
+
+const issues = [];
+const fixed = [];
+
+const normalizeEol = (content) => content.replace(/\r\n/g, '\n');
+
+const record = (file, message, { fixable = true } = {}) => {
+  if (!fixMode || !fixable) {
+    issues.push(`${file}: ${message}`);
+    return;
+  }
+  fixed.push(`${file}: ${message}`);
+};
+
+const checkTrailingWhitespace = (file) => {
+  const originalContent = fs.readFileSync(file, 'utf8');
+  const lines = normalizeEol(originalContent).split('\n');
+  let mutated = false;
+
+  const trimmed = lines.map((line, idx) => {
+    if (/[ \t]+$/.test(line)) {
+      record(file, `line ${idx + 1} has trailing whitespace`);
+      mutated = true;
+      return line.replace(/[ \t]+$/, '');
+    }
+    return line;
+  });
+
+  let finalContent = trimmed.join('\n');
+  if (!finalContent.endsWith('\n')) {
+    record(file, 'missing final newline');
+    mutated = true;
+    finalContent += '\n';
+  }
+
+  if (fixMode && mutated) {
+    fs.writeFileSync(file, finalContent, 'utf8');
+  }
+};
+
+const checkHtml = (file) => {
+  const content = fs.readFileSync(file, 'utf8');
+  if (!content.includes('<title>')) {
+    record(file, 'missing <title> tag');
+  }
+  if (!content.includes('Paywaz Documentation Hub')) {
+    record(file, 'expected landing heading content');
+  }
+};
+
+for (const file of filesToCheck) {
+  if (!fs.existsSync(file)) {
+    record(file, 'file is missing', { fixable: false });
+    continue;
+  }
+
+  checkTrailingWhitespace(file);
+
+  if (file.endsWith('.html')) {
+    checkHtml(file);
+  }
+}
+
+if (issues.length > 0) {
+  console.error('Lint issues found:');
+  issues.forEach((issue) => console.error(`- ${issue}`));
+  if (!fixMode) {
+    console.error('\nRun `npm run format` to attempt to fix trailing whitespace and newline issues.');
+  }
+  process.exit(1);
+}
+
+if (fixMode && fixed.length > 0) {
+  console.log('Applied fixes for:');
+  fixed.forEach((item) => console.log(`- ${item}`));
+}
+
+console.log('Lint checks passed.');
diff --git a/scripts/serve.js b/scripts/serve.js
new file mode 100644
index 0000000..2f0ec6b
--- /dev/null
+++ b/scripts/serve.js
@@ -0,0 +1,50 @@
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const url = require('url');
+
+const [, , rootDirArg = 'docs', portArg = '4173'] = process.argv;
+const rootDir = path.resolve(rootDirArg);
+const port = Number(portArg) || 4173;
+
+if (!fs.existsSync(rootDir)) {
+  console.error(`Directory not found: ${rootDir}`);
+  process.exit(1);
+}
+
+const mimeTypes = {
+  '.html': 'text/html',
+  '.css': 'text/css',
+  '.js': 'application/javascript',
+  '.json': 'application/json',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+};
+
+const server = http.createServer((req, res) => {
+  const parsedUrl = url.parse(req.url);
+  const safePath = path.normalize(parsedUrl.pathname || '/').replace(/^\.\.(\/|\\)/, '');
+  let pathname = path.join(rootDir, safePath);
+
+  if (fs.existsSync(pathname) && fs.statSync(pathname).isDirectory()) {
+    pathname = path.join(pathname, 'index.html');
+  }
+
+  fs.readFile(pathname, (err, data) => {
+    if (err) {
+      res.statusCode = 404;
+      res.end('Not found');
+      return;
+    }
+
+    const ext = path.parse(pathname).ext;
+    res.setHeader('Content-Type', mimeTypes[ext] || 'text/plain');
+    res.end(data);
+  });
+});
+
+server.listen(port, () => {
+  console.log(`Serving ${rootDir} at http://localhost:${port}`);
+});
diff --git a/scripts/smoke.js b/scripts/smoke.js
new file mode 100644
index 0000000..90949ec
--- /dev/null
+++ b/scripts/smoke.js
@@ -0,0 +1,38 @@
+const fs = require('fs');
+const path = require('path');
+
+const requiredFiles = ['docs/index.html', 'docs/.nojekyll'];
+
+for (const file of requiredFiles) {
+  if (!fs.existsSync(file)) {
+    console.error(`Missing required file: ${file}`);
+    process.exit(1);
+  }
+}
+
+const indexPath = path.join('docs', 'index.html');
+const content = fs.readFileSync(indexPath, 'utf8');
+
+const assertions = [
+  {
+    check: content.includes('Paywaz Documentation Hub'),
+    message: 'Landing page title missing',
+  },
+  {
+    check: content.includes('window.__PAYWAZ_SPEC_URL__'),
+    message: 'Spec URL bootstrap variable missing',
+  },
+  {
+    check: content.includes('hellopaywaz.github.io/paywaz-sdk-js'),
+    message: 'SDK docs link missing',
+  },
+];
+
+const failures = assertions.filter((assertion) => !assertion.check);
+
+if (failures.length > 0) {
+  failures.forEach((failure) => console.error(failure.message));
+  process.exit(1);
+}
+
+console.log('Smoke check passed: docs page is present and wired to API + SDK references.');