Logic Pulse - Interactive Logic Gate Learning Portal

Logic Pulse is an open-source educational platform designed to teach digital logic fundamentals through interactive tutorials, challenges, and a visual circuit simulator. Built with Angular 18, it provides an engaging learning experience for students and enthusiasts exploring the world of logic gates and digital circuits.

Features

🎓 Interactive Tutorials

• Comprehensive lessons on logic gate fundamentals (AND, OR, NOT gates)
• Visual representations with truth tables
• Step-by-step progression through digital logic concepts
• Interactive lesson content with images and examples

🎯 Challenges System

• Multiple difficulty levels (Easy, Medium, Hard)
• Various question types:
  • Multiple choice questions
  • Text-based answers
  • Interactive canvas tasks for circuit design
• Progress tracking with level completion
• Configurable question size and types
• Real-time feedback on answers

🔧 Circuit Simulator

• Drag-and-drop visual circuit designer
• Interactive logic gate components powered by Konva.js
• Real-time circuit evaluation
• Support for:
  • AND gates
  • OR gates
  • NOT gates
  • Input switches
  • Output indicators (bulbs)
  • Circuit connections
• Visual feedback for circuit states

🎨 Additional Features

• Responsive design with mobile/tablet warnings
• User authentication system
• Progress persistence with cookies
• Confetti celebrations on level completion
• Claude AI integration for enhanced learning assistance
• Customizable settings

Technology Stack

• Frontend Framework: Angular 18
• UI Components: Angular Material, Bootstrap 5, ng-bootstrap
• Canvas Graphics: Konva.js for circuit simulation
• Styling: CSS with responsive design
• State Management: RxJS
• Authentication: Cookie-based session management
• AI Integration: Anthropic Claude SDK
• Build Tools: Angular CLI, Custom Webpack configuration

Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm or yarn package manager

Installation

1. Clone the repository:

git clone https://github.com/yourusername/logic-pulse-project.git
cd logic-pulse-project

2. Install dependencies:

npm install

3. Start the development server:

npm start

4. Navigate to http://localhost:4200/ in your browser

Available Scripts

• npm start - Run development server
• npm run build - Build for production
• npm test - Run unit tests
• npm run test-coverage - Run tests with coverage report

Project Structure

logic-pulse-project/
├── src/
│   ├── app/
│   │   ├── components/
│   │   │   ├── challenges/      # Challenge components
│   │   │   ├── simulator/       # Circuit simulator
│   │   │   ├── tutorials/       # Tutorial system
│   │   │   └── ...
│   │   ├── models/             # Data models and Konva shapes
│   │   ├── services/           # Angular services
│   │   └── ...
│   └── ...
├── public/
│   ├── images/                 # Gate images and assets
│   ├── lessons.json           # Tutorial content
│   └── questions.json         # Challenge questions
└── ...

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

License

This project is open source and available under the MIT License.

Acknowledgments

• Built with Angular 18 and the Angular ecosystem
• Uses Konva.js for interactive canvas graphics
• Includes Bootstrap for responsive design
• Integrates with Anthropic's Claude AI for enhanced learning features
• Community-driven development with contributions from multiple developers