deploy to github page

Author: dgaribiani

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @dgaribiani

.github/workflows/static.yml

@@ -0,0 +1,51 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    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: Build
+        run: npm run build -- --configuration production --base-href /devtools/
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist/devtools
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -1,47 +1,81 @@
-# Dev Toolbox
-
-A privacy-first, offline-friendly toolbox of developer utilities that runs entirely in the browser. No backend, no tracking by default.
-
-## Features
-- Angular + TypeScript, static build output
-- TailwindCSS + Angular Material UI with glassmorphism styling
-- CodeMirror 6 editor for rich inputs
-- Web Workers for heavy JSON/Text operations
-- Offline-ready PWA (service worker)
-- Modular, lazy-loaded routes per tool category
-
-## Local Development
-1. Install dependencies:
-
+# Dev Toolbox
+
+A privacy-first, offline-friendly toolbox of developer utilities that runs entirely in the browser. No backend required, and no tracking by default.
+
+## Highlights
+- Built with Angular + TypeScript and shipped as static assets.
+- TailwindCSS + Angular Material with a glassmorphism UI.
+- CodeMirror 6 for rich editor inputs.
+- Web Workers for heavy JSON/Text operations.
+- Offline-ready PWA in production builds.
+- Modular, lazy-loaded routes per tool category.
+
+## Supported Tools
+JSON Core:
+- JSON Formatter / Validator
+- JSON Minifier
+- JSON Canonicalizer
+- JSON Diff
+- JSON <-> YAML
+- JSON Schema Validator
+- JSONPath Evaluator
+- JSON Patch (RFC 6902)
+- JSON Merge Patch
+- JSON -> Types
+- JSON5 / JSONC -> JSON
+
+Text Tools:
+- Text Diff
+- Regex Tester
+- Text Editor + Counter
+- Whitespace Normalizer
+- Markdown Preview
+- Unicode Inspector
+
+Crypto & Encoding:
+- Base64 Encode/Decode
+- URL Encode/Decode
+- JWT Decoder
+- Hash Generator
+- UUID Generator
+- UUIDv7 / ULID
+- HMAC Generator
+- Password Generator
+
+Data Utilities:
+- Timestamp Converter
+- CSV <-> JSON
+- Cron Next Run
+- Timezone Converter
+- CSV Profiler
+- OpenAPI Snippet Viewer
+
+SQL Tools:
+- SQL Formatter / Minifier
+- SQL IN Clause Builder
+- SQL Identifier Escaper
+- Execution Plan Analyzer
+
+## Quick Start
 ```bash
 npm install
-```
-
-2. Run the dev server:
-
-```bash
 npm start
 ```
 
-Open `http://localhost:4200/`.
+Then open `http://localhost:4200/`.
 
-## Build
+## Scripts
+- `npm start`: Run the dev server (development configuration).
+- `npm run build`: Production build.
+- `npm run watch`: Build in watch mode for development.
+- `npm test`: Run unit tests.
 
-```bash
-npm run build
-```
-
-Static assets are emitted to `dist/dev-toolbox`.
-
-## Tests
-
-```bash
-npm test
-```
+## Build Output
+Production builds emit static assets to `dist/devtools`.
 
-## Static Hosting (S3 + CloudFront)
-1. Build the app and upload the contents of `dist/dev-toolbox` to your S3 bucket.
-2. Configure S3 for static website hosting.
+## Deploying (S3 + CloudFront)
+1. Build the app and upload the contents of `dist/devtools` to your S3 bucket.
+2. Enable S3 static website hosting.
 3. CloudFront:
    - Set default root object to `index.html`.
    - Add custom error responses for 403/404 to serve `/index.html` with HTTP 200 (SPA routing).
@@ -60,4 +94,17 @@ Paste your Carbon Ads / EthicalAds / AdSense snippet in the commented section wi
 - No user input is sent to any server.
 - Analytics are off by default and optional.
 - JWT decoder is **decode-only** and does not verify signatures.
-- “Remember my inputs” is off by default; enabling it stores inputs locally on this device.
+- "Remember my inputs" is off by default; enabling it stores inputs locally on this device.
+
+## Contributor Guidelines
+- Keep changes focused and incremental; avoid drive-by refactors.
+- Follow existing Angular + TypeScript patterns and keep lint/build clean.
+- Prefer pure, testable functions for data transforms and heavy parsing.
+- Use Web Workers for CPU-heavy operations to keep the UI responsive.
+- Keep UI components accessible (labels, contrast, keyboard focus, ARIA where needed).
+- Respect privacy-by-default: no new tracking, network calls, or telemetry without explicit discussion.
+- Update docs when you add or change tools, routes, or build behavior.
+
+Before opening a PR:
+- Run `npm test` and `npm run build`.
+- Verify the affected tool in the browser (inputs, outputs, and error states).

angular.json

@@ -17,6 +17,10 @@
         "build": {
           "builder": "@angular/build:application",
           "options": {
+            "outputPath": {
+              "base": "dist/devtools",
+              "browser": "."
+            },
             "browser": "src/main.ts",
             "tsConfig": "tsconfig.app.json",
             "webWorkerTsConfig": "tsconfig.worker.json",
@@ -32,7 +36,9 @@
             ],
             "allowedCommonJsDependencies": [
               "ajv",
-              "papaparse"
+              "papaparse",
+              "json5",
+              "nearley"
             ]
           },
           "configurations": {