⚡ DevUtils - Cross-Platform Developer & QA Utilities

DevUtils is an open-source, air-gapped desktop application engineered for software developers and QA automation engineers. It bundles 18 essential day-to-day utilities into a fast, privacy-first interface that never transmits your data over the internet.

📖 Detailed Reference: Check the Complete Utilities Catalog & Reference.

---

🛡️ Why DevUtils? (Security & Privacy Compliance)

When developers and QA specialists paste production payloads, customer tokens, database exports, or secrets into random web tools (online JSON formatters, JWT decoders, base64 converters), critical company and customer data can be leaked or logged by remote servers.

DevUtils runs 100% locally on your machine:

• Air-gapped by design: No outbound telemetry, no analytics, no external CDN dependencies.
• Electron Sandbox: Enforces strict contextIsolation, disabled nodeIntegration, and secure preload IPC communication.
• Compliant with GDPR, HIPAA, and SOC-2: Safely format, decode, and inspect sensitive enterprise tokens and logs without risk.

Read the detailed Security & Compliance Guide.

---

🧰 Included Utilities (18 Tools)

Category	Utility	Description
Data & Formatting	JSON Prettifier & Minifier	Validate, format (2/4 spaces), and minify payloads with instant error diagnostics.
	JSON ↔ CSV Converter	Transform JSON arrays of objects to CSV spreadsheets and vice-versa.
	XML Prettifier & Validator	Indent nested XML documents with syntax inspection.
	SQL Query Beautifier	Standardize keyword casing and formatting for complex database queries.
Security & Tokens	JWT Inspector	Decode header, payload claims, expiry countdown, and timestamps offline.
	Cryptographic Hashes & HMAC	Instant checksums: MD5, SHA-1, SHA-256, SHA-512, and secret-keyed HMAC.
	Secure Password Generator	Cryptographically random passwords with custom symbols, numbers, and length.
Encoding & Codecs	Base64, URL & HTML Codec	UTF-8 safe encoding and decoding for web tokens, query strings, and markup.
	Hex ↔ Text Converter	Bidirectional conversion between raw UTF-8 text and hexadecimal byte strings.
Testing & QA	Regex Tester & Debugger	Test patterns against sample text with real-time match count and group breakdown.
	Text Diff & Comparison	Compare expected vs. actual outputs with color-coded unified diff view.
	UUID & QA Mock Data	Generate UUID v4/v1 IDs and randomized mock user datasets (JSON) for test scenarios.
	HTTP Status & Headers	Instant offline lookup for HTTP status codes (2xx, 3xx, 4xx, 5xx) and RFC meanings.
Network & APIs	cURL to Code Converter	Convert cURL commands into JavaScript fetch and Python requests snippets.
	CIDR / Subnet Calculator	Compute IPv4 netmasks, network bounds, broadcast addresses, and usable host counts.
Time & Text	Unix Timestamp / Epoch	Convert between Unix epoch seconds/milliseconds and human UTC / Local dates.
	String Cases & Text Stats	camelCase, PascalCase, snake_case, kebab-case, word count, line count, and byte size.
	Cron Expression Explainer	Translate standard 5-part cron syntax into clear human English.
	Markdown to HTML Preview	Offline Markdown parser with live HTML rendering and preview.
	Lorem Ipsum Text Generator	Instant multi-paragraph dummy text for UI mockups and testing.
Web & Styling	Color Palette Converter	Bidirectional converter between HEX, RGB, RGBA, and HSL with interactive swatch.
	URL & Query String Parser	Decompose URI parts and extract query string parameters into structured JSON.

---

🚀 Quick Start (Build & Run from Source)

Prerequisites

• Node.js (v18.x or v20.x LTS recommended)
• npm (bundled with Node.js)
• Git

Installation

# 1. Clone the repository
git clone https://github.com/techwasti/dev-utils.git
cd dev-utils

# 2. Install dependencies
npm install

# 3. Run unit tests
npm test

# 4. Start the application locally
npm start

---

📦 Multi-OS Executable Packaging

DevUtils packages into native installers and single-file portable binaries for all major desktop platforms:

# Package for Windows (.exe installer & portable)
npm run dist:win

# Package for macOS (.dmg and .zip)
npm run dist:mac

# Package for Linux (.AppImage, .deb, .rpm)
npm run dist:linux

All build artifacts will be generated in the release/ folder. For detailed instructions, refer to the Build & Packaging Guide.

---

🤖 Automated CI/CD & GitHub Actions

DevUtils includes pre-configured GitHub Actions workflows:

1. Automated Cross-Platform Builds (.github/workflows/build-and-release.yml):
   • Automatically executes test suites across Ubuntu.
   • Concurrently builds native .exe, .dmg, and .AppImage binaries on tag pushes (v*).
   • Generates and publishes releases directly to GitHub Releases with downloadable binaries.
2. GitHub Pages Documentation (.github/workflows/pages.yml):
   • Automatically deploys the interactive product portal in docs/ to GitHub Pages upon merge to main.
   • See the GitHub Pages Guide to enable hosting in 1 click.

---

🤝 Contributing

We welcome contributions from developers, QA automation engineers, and security researchers!

• Read our Contributing Guide to learn how to propose new offline utilities and run tests.
• Use our standardized templates for Bug Reports and Feature Requests.
• Review our Pull Request Checklist.

---

📄 License

This project is licensed under the MIT License. Feel free to use it across personal and commercial enterprise environments.