Skip to content

Repository files navigation

tols

STAYS LOCAL

Deploy License: MIT

Developer tools, available both as a website and as a command line program. The web version runs entirely in your browser: there is no backend, no account, and nothing is sent anywhere. The CLI has no runtime dependencies.

When a web action has a CLI equivalent, the page shows its exact runnable command; a surface-specific action does not advertise an approximation.

tols json fmt @config.json
tols b64 enc "hello" | tols b64 dec
tols hash sha256 <<< "secret"

Tools

Data

Tool What it does CLI
JSON Formatter Format, validate and beautify JSON tols json fmt
YAML Formatter Format YAML and convert it to JSON tols yaml fmt
XML Formatter Format, validate and minify XML tols xml fmt
HTML Formatter Beautify and minify HTML tols html fmt
Markdown Previewer Preview Markdown and convert it to HTML tols markdown html
Regex Tester Test regular expressions against sample text tols regex match
Diff Checker Compare two texts with word level precision tols diff
SQL Formatter Format and beautify SQL queries tols sql fmt

Encoding

Tool What it does CLI
Base64 Encode and decode Base64 tols base64 enc
URL Encoder Encode and decode URLs and query parameters tols url enc
JWT Decoder Inspect a token's header, payload and signature tols jwt dec
JWT Encoder Create and sign a token with HS256 tols jwt enc
JSONP Tester Wrap a payload in a JSONP callback tols jsonp wrap
Gzip Calculator Measure how far a payload compresses tols gzip comp
Data URI Generator Turn a file into a data URI tols datauri enc

Generators

Tool What it does CLI
UUID Generator Generate UUID v4 identifiers tols uuid gen
Hash Calculator MD5, SHA-1, SHA-256 and SHA-512 tols hash sha256
Lorem Ipsum Generate placeholder text tols lorem gen
QR Code Generate QR codes from text or a URL tols qr gen
Barcode Generate Code128 barcodes tols barcode gen
Password Generator Generate passwords and show their entropy tols password gen
Image Placeholder Generate placeholder images tols placeholder gen

Converters

Tool What it does CLI
Color Converter Convert between HEX, RGB and HSL tols color conv
Timestamp Convert Unix timestamps to readable dates tols timestamp conv
Time Zone Convert a time between zones tols timezone conv
Number Base Convert between decimal, binary, hex and octal tols base conv
Cron Parser Explain an expression and list its next runs tols cron parse
Unicode Inspector Look up characters and their properties tols unicode info
CSS Formatter Beautify and minify CSS tols css fmt
CSS Filter Generator Build a CSS filter chain visually tols cssfilter gen

Run tols <tool> help for a tool's flags, or tols help for the full list.

Web features

  • Shareable links for supported tools, with the tool's state encoded in the URL
  • Favourites and recent tools, kept in your browser
  • ⌘K to search, ⌘B to toggle the sidebar
  • Light and dark themes

Repository layout

apps/web         SvelteKit site, static build, deployed to GitHub Pages
packages/tols    the CLI and the shared core, published to npm

The core lives in packages/tols/src/core/. Those modules use no Node specific APIs, so the same files are imported by the CLI and bundled into the site. The CLI adapters in packages/tols/src/tools/ wrap them in argument parsing, and the Svelte components in apps/web/src/lib/tools/ wrap them in a UI.

Every web tool imports the shared core, so a fix lands in both places at once. Getting there was worth it for what it turned up: the two copies had drifted, and in eight tools the browser version was the wrong one. The site was handing out QR codes built by an encoder that ignored half the specification, and a barcode encoder that turned 12345 into 123405.

Development

git clone https://github.com/arasovic/tols.git
cd tols
npm install
npm run dev
Command Effect
npm run dev Start the site on a local dev server
npm test Run both test suites
npm run check Type check the Svelte app with svelte-check
npm run build Static production build into apps/web/build/

Every push to main runs the tests, the type check and the build before deploying, so a red suite never reaches the site.

Contributing

See CONTRIBUTING.md. Bug reports and new tools are both welcome. A new tool is wired through the shared core, the CLI registry, the web registry, the SEO metadata, the command template, and the dynamic route; see the checklist there.

License

MIT, see LICENSE.

About

Developer tools as a website and a zero-dependency CLI. No backend, no accounts, nothing leaves your browser.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages