{"id":31690324,"url":"https://github.com/zntb/nextjs-text-to-machine-code-converter","last_synced_at":"2025-10-08T12:54:36.152Z","repository":{"id":301524418,"uuid":"1009513779","full_name":"zntb/nextjs-text-to-machine-code-converter","owner":"zntb","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-27T09:19:11.000Z","size":205,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T10:27:30.327Z","etag":null,"topics":["nextjs","shadcn-ui","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://nextjs-text-to-machine-code-convert.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/zntb.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":"2025-06-27T08:56:30.000Z","updated_at":"2025-06-27T10:08:48.000Z","dependencies_parsed_at":"2025-06-27T10:27:58.958Z","dependency_job_id":"b57f55f0-cd7d-4536-bb31-701861349be4","html_url":"https://github.com/zntb/nextjs-text-to-machine-code-converter","commit_stats":null,"previous_names":["zntb/nextjs-text-to-machine-code-converter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zntb/nextjs-text-to-machine-code-converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zntb%2Fnextjs-text-to-machine-code-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zntb%2Fnextjs-text-to-machine-code-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zntb%2Fnextjs-text-to-machine-code-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zntb%2Fnextjs-text-to-machine-code-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zntb","download_url":"https://codeload.github.com/zntb/nextjs-text-to-machine-code-converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zntb%2Fnextjs-text-to-machine-code-converter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278948022,"owners_count":26073748,"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-08T02:00:06.501Z","response_time":56,"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":["nextjs","shadcn-ui","tailwindcss","typescript"],"created_at":"2025-10-08T12:54:26.426Z","updated_at":"2025-10-08T12:54:36.146Z","avatar_url":"https://github.com/zntb.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Text to Machine Code Converter\n\n[![Next.js](https://img.shields.io/badge/Next.js-15.0-black?style=flat-square\u0026logo=next.js)](https://nextjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=flat-square\u0026logo=typescript)](https://www.typescriptlang.org/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-4.0-38B2AC?style=flat-square\u0026logo=tailwind-css)](https://tailwindcss.com/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](https://opensource.org/licenses/MIT)\n\nA powerful, interactive web-based tool that converts high-level programming code and assembly instructions into machine code for different processor architectures. Built with Next.js 15, TypeScript, and modern React patterns.\n\n![Machine Code Converter Preview](./public//preview.png)\n\n## ✨ Features\n\n### 🎯 **Core Functionality**\n\n- **Multi-Architecture Support**: Convert code for x86-64 (Intel/AMD) and ARM64 (Apple Silicon) architectures\n- **Multiple Input Languages**: Support for C and Assembly languages\n- **Real-time Conversion**: Instant machine code and assembly generation\n- **Binary Conversion**: Convert text, numbers, and machine code to binary representation\n\n### 🔧 **Advanced Features**\n\n- **Multiple Text Encodings**: ASCII, UTF-8, and UTF-16 support\n- **Interactive Examples**: Quick-load examples for different use cases\n- **Copy to Clipboard**: One-click copying of generated output\n- **Responsive Design**: Works seamlessly on desktop and mobile devices\n- **Dark Theme**: Professional dark-themed output displays\n\n### 🎨 **User Experience**\n\n- **Modern UI/UX**: Clean, professional interface with smooth animations\n- **Tabbed Output**: Organized display of machine code, assembly, and binary\n- **Visual Feedback**: Toast notifications and loading states\n- **Accessibility**: Screen reader friendly with proper ARIA labels\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 18.0 or later\n- npm, yarn, or pnpm package manager\n\n### Installation\n\n1. **Clone the repository**\n\n   ```bash\n   https://github.com/zntb/nextjs-text-to-machine-code-converter.git\n   cd nextjs-text-to-machine-code-converter\n   ```\n\n2. **Install dependencies**\n\n   ```bash\n   npm install\n   # or\n   yarn install\n   # or\n   pnpm install\n   ```\n\n3. **Run the development server**\n\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   # or\n   pnpm dev\n   ```\n\n4. **Open your browser**\n   Navigate to [http://localhost:3000](http://localhost:3000) to see the application.\n\n## 📖 Usage\n\n### Basic Conversion\n\n1. **Select your target architecture** (x86-64 or ARM64)\n2. **Choose the source language** (C or Assembly)\n3. **Enter your code** in the input textarea\n4. **Click \"Convert to Machine Code\"** to generate output\n5. **View results** in the tabbed output section\n\n### Binary Conversion Modes\n\n- **Text to Binary**: Convert any text using ASCII, UTF-8, or UTF-16 encoding\n- **Machine Code to Binary**: Convert generated machine code to binary representation\n- **Numbers to Binary**: Convert decimal numbers to their binary equivalents\n\n### Quick Examples\n\nUse the provided example buttons to quickly load:\n\n- Hello World program in C\n- Simple loop structures\n- Assembly instructions\n- Unicode text samples\n\n## 🏗️ Architecture\n\n### Project Structure\n\n```image\nsrc/\n├── app/\n│   ├── components/           # React components\n│   │   ├── ConfigurationPanel.tsx\n│   │   ├── ExampleButtons.tsx\n│   │   ├── CodeInput.tsx\n│   │   ├── OutputTabs.tsx\n│   │   └── InfoSection.tsx\n│   ├── constants/           # Application constants\n│   │   └── examples.ts\n│   ├── types/              # TypeScript type definitions\n│   │   └── index.ts\n│   ├── utils/              # Utility functions\n│   │   ├── machineCodeGenerator.ts\n│   │   └── binaryConverter.ts\n│   ├── globals.css         # Global styles\n│   ├── layout.tsx          # Root layout\n│   └── page.tsx            # Main page component\n├── components/ui/          # shadcn/ui components\n└── lib/                    # Shared utilities\n```\n\n### Key Components\n\n- **ConfigurationPanel**: Manages architecture, language, and encoding settings\n- **ExampleButtons**: Provides quick-load functionality for code examples\n- **CodeInput**: Handles code input with syntax highlighting preparation\n- **OutputTabs**: Displays machine code, assembly, and binary output\n- **InfoSection**: Educational content about the conversion process\n\n### Technologies Used\n\n- **Framework**: Next.js 15 with App Router\n- **Language**: TypeScript for type safety\n- **Styling**: Tailwind CSS for responsive design\n- **UI Components**: shadcn/ui component library\n- **Icons**: Lucide React icons\n- **Notifications**: Sonner for toast messages\n\n## 🛠️ Development\n\n### Code Quality\n\nThis project follows modern React and TypeScript best practices:\n\n- **Type Safety**: Comprehensive TypeScript coverage\n- **Component Architecture**: Modular, reusable components\n- **Performance**: Optimized with React hooks and memoization\n- **Error Handling**: Robust error boundaries and user feedback\n- **Accessibility**: WCAG compliant interface elements\n\n### Available Scripts\n\n```bash\n# Development server\nnpm run dev\n\n# Production build\nnpm run build\n\n# Start production server\nnpm start\n\n# Lint code\nnpm run lint\n\n# Type checking\nnpm run type-check\n```\n\n### Environment Variables\n\nCreate a `.env.local` file for local development:\n\n```env\n# Add any environment variables here\nNEXT_PUBLIC_APP_NAME=\"Machine Code Converter\"\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. **Fork the repository**\n2. **Create a feature branch**\n   ```bash\n   git checkout -b feature/amazing-feature\n   ```\n3. **Make your changes**\n4. **Add tests** if applicable\n5. **Commit your changes**\n   ```bash\n   git commit -m 'Add some amazing feature'\n   ```\n6. **Push to the branch**\n   ```bash\n   git push origin feature/amazing-feature\n   ```\n7. **Open a Pull Request**\n\n### Development Guidelines\n\n- Follow the existing code style and patterns\n- Add TypeScript types for new features\n- Update documentation for significant changes\n- Test your changes thoroughly\n- Keep components focused and reusable\n\n## 📚 Educational Value\n\nThis tool serves as an excellent educational resource for:\n\n- **Computer Science Students**: Understanding low-level programming concepts\n- **Software Engineers**: Learning about different processor architectures\n- **Assembly Programmers**: Visualizing machine code generation\n- **Educators**: Teaching computer architecture and systems programming\n\n## 🔧 Supported Architectures\n\n### x86-64 (Intel/AMD)\n\n- Modern 64-bit instruction set\n- Common patterns for C and assembly code\n- Hexadecimal machine code generation\n\n### ARM64 (Apple Silicon)\n\n- 64-bit ARM instruction set\n- Optimized for modern ARM processors\n- Support for Apple Silicon Macs\n\n## 📋 Roadmap\n\n- [ ] **Additional Architectures**: RISC-V, MIPS support\n- [ ] **More Languages**: Python, JavaScript bytecode\n- [ ] **Syntax Highlighting**: Real-time code highlighting\n- [ ] **Export Options**: Save output as files\n- [ ] **Collaboration**: Share code snippets via URL\n- [ ] **Performance Metrics**: Execution time estimates\n\n## 🐛 Issues and Support\n\nIf you encounter any issues or have questions:\n\n1. Check the [Issues](https://github.com/yourusername/machine-code-converter/issues) page\n2. Create a new issue with detailed information\n3. Include steps to reproduce the problem\n4. Attach screenshots if applicable\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- **shadcn/ui** for the beautiful component library\n- **Tailwind CSS** for the utility-first CSS framework\n- **Lucide** for the comprehensive icon set\n- **Next.js** team for the amazing React framework\n\n## 📞 Contact\n\n- **GitHub**: [@zntb](https://github.com/zntb)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eMade with ❤️ for the developer community\u003c/p\u003e\n  \u003cp\u003e⭐ Star this repository if you find it helpful!\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzntb%2Fnextjs-text-to-machine-code-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzntb%2Fnextjs-text-to-machine-code-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzntb%2Fnextjs-text-to-machine-code-converter/lists"}