Skip to content

oyjq0000/BinaryCodeTranslator

Repository files navigation

Binary Code Translator (Static HTML Version)

Looking for the live application? This repository contains the original v1 static architecture. The modern, fully-featured application is live at: https://binary-code-translator.com/ 🚀

About

This is a lightweight, open-source collection of binary and text conversion tools built with pure HTML, CSS, and JavaScript. It serves as the foundational codebase (v1) for the Binary Code Translator project.

If you are looking for a simple, zero-dependency implementation of conversion algorithms, this repository is free to use and modify.

Features

  • Text ↔ Binary - Bidirectional conversion with Unicode support
  • Binary ↔ Decimal - Base-2 to base-10 conversion
  • Binary ↔ Hexadecimal - Base-2 to base-16 conversion
  • ASCII ↔ Binary - ASCII character encoding
  • Multi-Base Converter - Convert between bases 2-62
  • Base64 Encoder/Decoder - Client-side Base64 processing
  • URL Encoder/Decoder - Standard URL encoding tools

Project Evolution

We believe in open source. While our production site has moved to a modern React framework, we keep this static version available for educational purposes and for developers who need a lightweight solution.

Version Tech Stack Description Link
v2 (Current) Next.js Server-side rendering, enhanced UI, faster performance Visit Official Site
v1 (This Repo) HTML/JS Zero dependencies, runs offline, pure client-side View Code

Technical Stack

  • Pure HTML5/CSS3/ES6+ - No frameworks needed
  • Zero Dependencies - No npm install, no build step
  • SEO Optimized Architecture - Semantic HTML structure
  • Responsive Design - Mobile-first approach with dark/light mode
  • 100% Client-Side - Privacy-focused, all processing happens in the browser

Project Structure

├── index.html              # Main text ↔ binary converter
├── text-to-binary.html     # Text to binary conversion
├── binary-to-text.html     # Binary to text conversion
├── binary-to-decimal.html  # Binary to decimal conversion
├── binary-to-hex.html      # Binary to hexadecimal conversion
├── ascii-to-binary.html    # ASCII to binary conversion
├── base-converter.html     # Multi-base converter (2-62)
├── base64-encoder.html     # Base64 encoder/decoder
├── url-encoder.html        # URL encoder/decoder
├── css/
│   └── style.css           # Unified stylesheet
├── js/
│   ├── converter.js        # Core conversion logic
│   └── ui-controller.js    # UI state management
└── blog/                   # Static blog templates

Getting Started

Since this is a static site (MPA) with no build process, you can run it instantly:

Option 1: Python (Mac/Linux)

python -m http.server 8000

Option 2: Node.js (via serve)

npx serve .

Option 3: Direct Access Simply double-click index.html to open it in your browser (note: some distinct UI features might require a local server environment).

Quick Deploy

Deploy your own copy with one click:

Deploy with Vercel Deploy to Netlify


Deployment

This project is ready to be deployed to any static hosting service immediately:

  • GitHub Pages - Free, built into GitHub (enable in Settings → Pages)
  • Vercel - Click the button above
  • Netlify - Click the button above
  • Cloudflare Pages - Connect your GitHub repo

No build command is required. Publish the root directory.

License

This project is licensed under the MIT License. You are free to use this code for personal or commercial projects. If you use this code, a link back to binary-code-translator.com is appreciated but not required.