Thanks to visit codestin.com
Credit goes to github.com

Skip to content

DoctorLai/base64-converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

40 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”€ Base64 Converter

Base64 Converter (Built, Lint and Test) Run Tests with Coverage

A simple web-based tool to encode or decode Base64 strings or files. This app is built using React and runs directly in your browser. It provides an easy-to-use interface with two text areasβ€”just paste your content and convert instantly, or upload files for encoding.

This tool also supports decoding of .b64 files into their original binary form.

πŸš€ Features

  • Base64 Encode/Decode: Convert plain text to Base64 and vice versa.
  • File Upload: Upload files to encode or .b64 files to decode.
  • Download Results: Download the converted content as .b64 or .bin.
  • Dark Mode: Toggle between light and dark themes.
  • Tab Support: Proper indentation when using the "Tab" key in text areas.
  • Simple and Intuitive UI: Clean interface that's beginner-friendly.
  • Easy Deployment: Use npm run build and npm run deploy for production.

🌐 Live Demo

Try it out on GitHub Pages: Base64 Converter

image

Please note: this is the open source version of this online tool: Base64 Encoder/Decoder (Javascript) for Text/Binary Files

πŸ›  Installation

To run the tool locally:

  1. Clone the repository:
git clone https://github.com/doctorlai/base64-converter.git
cd base64-converter
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Run tests:
## or: npm test
npm run test
  1. Test coverage:
npx vitest run --coverage
  1. Coding format check: Use prettier to either check or format the source code:
npm run format
## fix the code style automatically
npm run format:fix
  1. Open http://localhost:5173/base64-converter/ in your browser.

✨ Usage

πŸ“„ Text Encoding/Decoding

  1. Enter plain text in the input box.
  2. Click ENcode β†’ to encode the string to Base64.
  3. Enter Base64-encoded string in the input box.
  4. Click β€œβ† Decode” to decode.

πŸ“ File Encoding/Decoding

  • To encode a file:

    • Select a file using the "Load File" button.
    • If the file is binary, it will be encoded automatically.
    • Click Save File to save the result as .b64.
  • To decode a file:

    • Select a .b64 file using the "Load File" button.
    • On success, the output will show the decoded binary (which seems random output).
    • Click Save File to save the decoded content (in binary).

Use the 🌞/πŸŒ™ toggle on top to switch between Light and Dark mode.

🀝 Contributing

We welcome contributions!

  1. Fork the repo.
  2. Create your feature branch:
git checkout -b feature-name
  1. Commit your changes:
git commit -am 'Add cool feature'
  1. Push to GitHub:
git push origin feature-name
  1. Open a pull request πŸš€

πŸ“„ License

This project is licensed under the MIT License β€” see the LICENSE file.

Documentation

Here is the AI generated wiki

πŸ™ Acknowledgments

  • Made with ❀️ by @justyy
  • Initial Boilerplate code contributed by ChatGPT-4o and o4-mini.
  • Like this project? Consider buying me a coffee β˜•