Skip to content

README.md

Latest commit

 

History

History
76 lines (47 loc) · 3.56 KB

README.md

File metadata and controls

76 lines (47 loc) · 3.56 KB
Raw

ToolStack

Privacy-first browser tools. Your data stays on your device.

ToolStack is a free, open-source toolbox with 60 tools that run locally in your browser. No accounts, uploads, ads or analytics.

What you can do

  • Privacy: sanitize support files, redact screenshots, inspect metadata, and encrypt files or notes.
  • Developer tools: compare files, work with JSON/CSV/XML/YAML, test regex and plan IPv4 subnets.
  • PDFs and images: compress, merge or split PDFs; resize, crop and convert images.
  • Calculators: split bills, compare prices, model loans and savings, or calculate with variables and units.
  • Design and websites: build CSS gradients and grids, prepare SVGs, and generate favicons, metadata, robots.txt and sitemaps.
  • Generators: create QR codes, repeatable test datasets, shell templates and ASCII art.

Search or browse by category, pin frequently used tools, and switch between light and dark mode. See the tool reference for detailed features and limitations.

Privacy

Working input is processed in the browser and isn't saved with the app. Only your theme preference and pinned tool IDs are stored locally. Fonts and processing libraries are bundled without third-party CDNs.

Review sensitive exports before sharing: automatic detection and sanitization have limits. The tool reference explains what each tool preserves or removes.

Run locally

Use Node.js 24, matching the project's CI.

git clone https://github.com/surajverma/toolstack.git
cd toolstack
npm ci
npm run dev

Open localhost:3000.

Offline and installation

Build and run the production app to enable offline use:

npm run build
npm start

The production app downloads all tools for offline use in the background, including ones you haven't opened yet. Install app appears once the download is complete and the browser offers installation, then disappears after installation. Installation is optional; supported browsers also offer it through their own menus.

The offline cache contains application resources, not your files or tool input. Browser storage can be cleared or evicted; reconnect to download the app again. Offline support requires HTTPS or localhost and is disabled during development.

Save your work before choosing Reload to update. For deployment and caching details, see the offline guide. Always run npm run build so the offline postbuild step is included.

Run with Docker

With Docker and Docker Compose installed:

docker compose up --build -d

Open localhost:5010. This builds the production app locally, including all offline assets; no published image or database is required. Stop it with docker compose down. After pulling updates, run the build command again.

Compose publishes port 5010 on all host interfaces. For self-hosting, change NEXT_PUBLIC_SITE_URL under build.args in compose.yml to your domain, then rebuild. The site URL is a build-time setting for sitemap and robots metadata. Use HTTPS through your reverse proxy when accessing the app beyond localhost, and bypass caching for /sw.js and /pwa/sw.js.

Contributing

Bug fixes, privacy improvements and useful local-only tools are welcome.

npm run verify

This runs the dependency audit, privacy check, lint, types, tests and production build. See the architecture guide for where code belongs and how to add a tool.

License

MIT · Support ToolStack