Microbox

A compact collection of small, fast, and practical developer utilities—everything in one place. URL shortener, UUID generators, hash tools, QR codes, JSON utilities, encoding/decoding helpers, fake data, and more. Built to be lightweight, modular, and easy to extend as new micro-apps are added.

Overview

Microbox is split into two main components:

• API: Python backend providing services that require server-side processing
• UI: Vue.js frontend offering both client-side tools and interfaces to API services

Architecture

microbox/
├── api/          # Python/Starlette backend
├── ui/           # Vue 3 frontend
└── docker-compose.yml

Features

Client-Side Tools

These tools run entirely in the browser without API calls:

Tool	Description
UUID Generator	Generate UUID v1, v3, v4, v5, and v7
Hash Generator	Create MD5, SHA1, SHA256, SHA512 hashes
Random String Generator	Generate random strings with custom length and character sets
JWT Encoder/Decoder	Encode and decode JWT tokens with signature verification
Base64 Encoder/Decoder	Convert text and binary data to/from Base64
JSON Formatter	Beautify, minify, and validate JSON
Diff Viewer	Compare two text blocks and visualize differences
Color Tool	Convert between HEX, RGB, and HSL; generate palettes
CPF/CNPJ Validator	Validate Brazilian CPF and CNPJ numbers
Password Generator	Generate passwords with configurable rules
Regex Validator	Test and debug regular expressions
Text Case Converter	Transform text into camelCase, snake_case, PascalCase, etc.

API-Backed Tools

These tools require server-side processing:

Tool	Description
Social Card Preview	Extract OpenGraph and Twitter Card metadata from URLs
QR Code Generator	Create scannable QR codes
Barcode Generator	Generate Code128 and other standard barcodes
Steganography	Hide and extract messages within images using LSB technique
URL Shortener	Create compact short URLs
Fake Data Generator	Generate realistic fake data for testing

Planned Features

• Timestamp Converter

Quick Start

Using Docker Compose

# Start both services
docker-compose up

# Start individual services
docker-compose up api
docker-compose up ui

Access the application:

• UI: http://localhost:8001
• API: http://localhost:8000
• API Health: http://localhost:8000/

Documentation

For detailed information about each component:

• API Documentation - Backend services, endpoints, and configuration
• UI Documentation - Frontend architecture, components, and development

License

MIT License - see LICENSE file for details.

Contributing

The project is designed to be modular and extensible. New utilities can be added as:

• Client-side tools in ui/src/components/apps/
• API services in api/src/services/

Each tool should be self-contained and follow the existing patterns for consistency.