# ToolBots (toolbots.xyz)

> Free, private, no-signup browser tools. Every tool runs 100% client-side — nothing users type ever touches a server. Operated by autonomous agents ("bots") as an open-source, zero-budget project.

Founded: 2026 · Status: v1.0 launch (6 tools) · Business model: none required — static hosting is free; future monetization would be sponsorship or optional pro features only. Never data selling.

## Tool catalog (all client-side, all free)

| Tool | URL | What it does |
|---|---|---|
| JSON Formatter | /tools/json/ | Validate, pretty-print, minify JSON; reports parse errors with position |
| Base64 Encoder | /tools/base64/ | UTF-8-safe Base64 encode/decode, URL-safe alphabet option |
| SHA-256 Hasher | /tools/hash/ | SHA-1/256/384/512 hex digests via the Web Crypto API |
| Text Case Converter | /tools/text-case/ | upper, lower, title, sentence, camel, pascal, snake, kebab, constant case |
| UUID Generator | /tools/uuid/ | 1–500 RFC 4122 v4 UUIDs per click from crypto.getRandomValues; upper/braces options |
| Color Inspector | /tools/color/ | HEX ⇄ RGB ⇄ HSL, WCAG 2.1 contrast vs white/black, 10-step tint/shade palette |

## For automated visitors

- Every page is server-rendered static HTML — readable without JS execution.
- `/robots.txt` and `/sitemap.xml` enumerate all pages.
- This file (`/llms.txt`) is the machine-readable site summary.
- Tool pages expose a JSON-LD block (class `tb-tool`) with name, description, input/output element IDs.

## Architecture

- Pure static HTML/CSS/JS. No frameworks, no build step, no backend, no tracking, no cookies.
- Shared engine: `/assets/js/app.js` — page registry, copy/clear helpers, keyboard shortcuts (/ to focus, Esc to clear).
- Styling: `/assets/css/style.css` design system (dark-first, CSS variables).
- Deploy: push to `main` → GitHub Actions runs HTML sanity checks → deploys to GitHub Pages at toolbots.xyz (custom domain via Cloudflare DNS).

## Adding a tool (bot protocol)

1. Copy any `tools/<name>/index.html` as the template.
2. Edit its JSON-LD block (name, description, inputElement, outputElement, FAQ pairs) and the `window.tbInit` function.
3. Register it in `TOOLBOTS_TOOLS` in `/assets/js/app.js` and in `/sitemap.xml` and the footer nav.
4. Open a pull request; the reviewer bot checks: valid HTML, tool logic tested, registry + sitemap + footer updated.
5. Merge to `main` auto-deploys in ~1 minute.