{"id":22711065,"url":"https://github.com/khamisilawrence/binary-string-converter","last_synced_at":"2025-10-10T15:10:27.630Z","repository":{"id":263526140,"uuid":"871705112","full_name":"khamisilawrence/binary-string-converter","owner":"khamisilawrence","description":"Web tool to simplify the process of converting binary data to text and vice versa.","archived":false,"fork":false,"pushed_at":"2025-09-24T14:20:37.000Z","size":875,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-24T16:27:10.852Z","etag":null,"topics":["binary-converter","binary-to-string","string-to-binary","typescript"],"latest_commit_sha":null,"homepage":"https://binary-string-converter.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/khamisilawrence.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-10-12T17:53:34.000Z","updated_at":"2025-09-24T14:20:41.000Z","dependencies_parsed_at":"2024-11-19T07:00:44.366Z","dependency_job_id":"2240e7f2-f604-4731-98e3-77c399568b64","html_url":"https://github.com/khamisilawrence/binary-string-converter","commit_stats":null,"previous_names":["khamisilawrence/binary-string-converter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/khamisilawrence/binary-string-converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khamisilawrence%2Fbinary-string-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khamisilawrence%2Fbinary-string-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khamisilawrence%2Fbinary-string-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khamisilawrence%2Fbinary-string-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khamisilawrence","download_url":"https://codeload.github.com/khamisilawrence/binary-string-converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khamisilawrence%2Fbinary-string-converter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279004573,"owners_count":26083735,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["binary-converter","binary-to-string","string-to-binary","typescript"],"created_at":"2024-12-10T12:13:51.047Z","updated_at":"2025-10-10T15:10:27.593Z","avatar_url":"https://github.com/khamisilawrence.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Binary-to-String Converter\n\n## Overview\n\nThe **Binary-to-String Converter** application is a utility web tool designed to simplify the process of converting binary data to text and vice versa. This tool is tailored for developers, students, and enthusiasts who work with binary data and need a quick, efficient way to encode or decode binary strings. Built with modern technologies like **Next.js**, **TypeScript**, and **TailwindCSS**, it offers a user-friendly interface and responsive design.\n\n## Features\n\n- **String to Binary Conversion**: Convert plain text into binary code.\n- **Binary to String Conversion**: Decode binary sequences into human-readable text.\n- **Copy to Clipboard**: Quickly copy the results to your clipboard.\n- **Responsive Design**: Optimized for use on both mobile and desktop devices.\n- **Accessibility**: Includes ARIA labels for improved accessibility.\n- **Light and Dark Modes**: Adapts to your system's theme preferences.\n- **Interactive Feedback**: Visual and textual feedback when copying results.\n\n## Project Structure\n\nThe project follows a modular and component-driven architecture:\n\n- **Pages**: Located under `src/app/`, includes main page components like `page.tsx`.\n- **Components**: Reusable UI components like buttons, headers, and text areas are in `src/components/`.\n- **Utils**: Conversion logic is modularized in `src/utils/conversion/`.\n- **Hooks**: Custom hooks, such as `useMediaQuery`, reside in `src/hooks/`.\n- **Constants**: Centralized text content and configuration in `src/constants/`.\n- **Assets**: Icons and other static assets are stored in `src/assets/`.\n\n## Technologies Used\n\n- **Framework**: [Next.js](https://nextjs.org) 14\n- **Language**: [TypeScript](https://www.typescriptlang.org/)\n- **Styling**: [TailwindCSS](https://tailwindcss.com/)\n- **Testing**: [Jest](https://jestjs.io/) and [React Testing Library](https://github.com/testing-library/react-testing-library)\n- **Icons**: Custom SVG components\n\n## Getting Started\n\n### Prerequisites\n\nEnsure you have the following installed on your system:\n\n- **Node.js** (v18 or newer)\n- **npm**, **yarn**, or another package manager\n\n### Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/khamisilawrence/binary-string-converter.git\n   cd binary-string-converter\n   ```\n\n2. Install dependencies\n\n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n### Running the Application\n\nTo start the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\nThe application should be accessible at \u003chttp://localhost:3000\u003e.\n\n### Running Tests\n\nTo execute the test suite:\n\n```bash\nnpm test\n# or\nyarn test\n```\n\n### Building for Production\n\nTo generate a production build:\n\n```bash\nnpm run build\n# or\nyarn build\n```\n\nThen, start the production server:\n\n```bash\nnpm start\n# or\nyarn start\n```\n\n## Usage\n\n### Conversion\n\n1. **Input**: Enter text or binary data in the input field.\n2. **Select Conversion Type**: Use the dropdown to choose between:\n    - **String to Binary**: Convert text to binary data.\n    - **Binary to String**: Convert binary data to text.\n\n3. **Convert**: Click the \"Convert\" button to view the results.\n4. **Copy to Clipboard**: Use the copy button to save the output for later use.\n\n### Example\n\n#### String to Binary\n\n- **Input**: `Hello`\n- **Output**: `01001000 01100101 01101100 01101100 01101111`\n\n#### Binary to String\n\n- **Input**: `01001000 01100101 01101100 01101100 01101111`\n- **Output**: `Hello`\n\n**Note**: The binary data is displayed as a string of hexadecimal pairs for readability.\n\n### Tests\n\nThe codebase includes comprehensive unit tests for:\n\n- Conversion logic (`src/utils/conversion/conversion.test.ts`)\n- UI components (`src/components/*/*.test.tsx`)\n- Custom hooks (`src/hooks/useMediaQuery/useMediaQuery.test.ts`)\n\nTo run all tests, execute:\n\n```bash\nnpm test\n```\n\n## License\n\nThis project is licensed under the [MIT License](https://opensource.org/license/mit). See [`LICENSE`](/LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhamisilawrence%2Fbinary-string-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhamisilawrence%2Fbinary-string-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhamisilawrence%2Fbinary-string-converter/lists"}