Neander.js

🇧🇷 Português | 🇺🇸 English

---

🇧🇷 Português

Sobre o Projeto

O Neander.js é uma implementação web interativa do processador hipotético Neander, desenvolvido para estudantes e entusiastas de arquitetura de computadores e eletrônica digital. Este simulador oferece uma interface moderna e intuitiva para aprender os conceitos fundamentais de processadores e programação em baixo nível.

✨ Funcionalidades

• 🖥️ Simulador Visual: Interface gráfica completa do processador Neander
• 💾 Memória de Programa: Edição e visualização da memória de programa
• 📊 Memória de Dados: Monitoramento da memória de dados em tempo real
• ⚡ Execução de Instruções: Execução passo a passo ou automática
• 🔧 Editor de Código: Editor integrado com syntax highlighting
• 📈 Registradores: Visualização dos registradores do processador
• 🎯 Debugging: Ferramentas de depuração e análise

🚀 Tecnologias Utilizadas

• Frontend: Vue.js 3, JavaScript ES6+
• Build Tool: Vite
• UI Framework: Bootstrap 5
• Editor: CodeMirror 6
• Ícones: Bootstrap Icons

📦 Instalação

1. Clone o repositório

   git clone https://github.com/seu-usuario/neander-js.git
   cd neander-js

2. Instale as dependências

   npm install

3. Execute o projeto em modo de desenvolvimento

   npm run dev

4. Acesse no navegador

   http://localhost:5173
   

🏗️ Build para Produção

npm run build

🌐 Acesso Online

Use gratuitamente online: kstrtech.com.br/neander-js

📖 Como Usar

1. Programação: Use o editor de código para escrever programas em assembly do Neander
2. Execução: Execute o programa passo a passo ou automaticamente
3. Debugging: Monitore registradores e memória durante a execução
4. Análise: Visualize o estado do processador em tempo real

🎓 Sobre o Processador Neander

O Neander é um processador hipotético criado para fins educacionais, baseado na arquitetura de Von Neumann. Ele possui:

• 8 bits de largura de dados
• 256 bytes de memória
• Conjunto de instruções simplificado
• Registradores básicos (AC, PC, etc.)

🤝 Contribuindo

Contribuições são bem-vindas! Para contribuir:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

🇺🇸 English

About the Project

Neander.js is an interactive web implementation of the hypothetical Neander processor, designed for students and enthusiasts of computer architecture and digital electronics. This simulator provides a modern and intuitive interface to learn fundamental concepts of processors and low-level programming.

✨ Features

• 🖥️ Visual Simulator: Complete graphical interface of the Neander processor
• 💾 Program Memory: Edit and visualize program memory
• 📊 Data Memory: Real-time data memory monitoring
• ⚡ Instruction Execution: Step-by-step or automatic execution
• 🔧 Code Editor: Integrated editor with syntax highlighting
• 📈 Registers: Processor register visualization
• 🎯 Debugging: Debugging and analysis tools

🚀 Technologies Used

• Frontend: Vue.js 3, JavaScript ES6+
• Build Tool: Vite
• UI Framework: Bootstrap 5
• Editor: CodeMirror 6
• Icons: Bootstrap Icons

📦 Installation

1. Clone the repository

   git clone https://github.com/your-username/neander-js.git
   cd neander-js

2. Install dependencies

   npm install

3. Run the project in development mode

   npm run dev

4. Access in browser

   http://localhost:5173
   

🏗️ Production Build

npm run build

🌐 Online Access

Use for free online: kstrtech.com.br/neander-js

📖 How to Use

1. Programming: Use the code editor to write Neander assembly programs
2. Execution: Run programs step-by-step or automatically
3. Debugging: Monitor registers and memory during execution
4. Analysis: Visualize processor state in real-time

🎓 About the Neander Processor

The Neander is a hypothetical processor created for educational purposes, based on Von Neumann architecture. It features:

• 8-bit data width
• 256 bytes of memory
• Simplified instruction set
• Basic registers (AC, PC, etc.)

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the project
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.

---