Skip to content

README.md

Latest commit

 

History

History
190 lines (135 loc) · 5.73 KB

README.md

File metadata and controls

190 lines (135 loc) · 5.73 KB

Neander js

Vue.js JavaScript Vite Bootstrap

🇧🇷 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.