Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 11 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,6 @@
### 🎮 **Interactive Visualizations**

- **2D SVG Models**: Smooth animations explaining complex concepts (30+ components)
- **3D Three.js Models**: Immersive 3D representations of programming constructs
- **Algorithm Animations**: Step-by-step execution of sorting, searching, and traversal algorithms
- **Data Structure Demos**: Interactive models for arrays, trees, graphs, and hash tables
- **Real-time Interactions**: Click, drag, and explore concepts dynamically
Expand Down Expand Up @@ -71,7 +70,6 @@
### **Visualization Technologies**

- **2D Graphics**: SVG-based interactive diagrams
- **3D Graphics**: Three.js for immersive 3D models
- **Animations**: CSS transitions and JavaScript-driven animations
- **Interactivity**: Mouse/touch events with real-time feedback

Expand All @@ -89,8 +87,6 @@ src/
│ │ │ ├── hash/ # HashTable visualization
│ │ ├── bigo/ # Big-O notation visualizations (10+ components)
│ │ └── python/ # Python programming visualizations
│ ├── models3d/ # 3D visualization components
│ │ └── python/ # Python 3D models (VM, memory profiler, call graph)
│ ├── playground/ # LeetCode-style playground components
│ │ ├── Playground.tsx # Main playground component
│ │ ├── ProblemDisplay.tsx # Problem statement and examples
Expand Down Expand Up @@ -130,7 +126,6 @@ src/
│ └── theme.ts # Theme and styling utilities
├── data/ # Static data and problem sets
│ └── problems.ts # LeetCode-style coding problems
└── three/ # Three.js 3D models and scenes
```

## 🚀 Quick Start
Expand Down Expand Up @@ -265,7 +260,6 @@ Comprehensive guide to fundamental data structures with interactive visualizatio
- **Hash Tables**: Hash functions, collision resolution, and performance analysis
- **Tree Structures**: Binary trees, BSTs, AVL trees, red-black trees, heaps, and B-trees
- **Graph Structures**: Graph representations, BFS/DFS traversals, and shortest path algorithms
- **3D Visualizations**: Interactive 3D models for complex data structure relationships
- **Practice Problems**: LeetCode-style coding challenges with step-by-step solutions
- **Real-world Applications**: Industry use cases from social media to database systems
- **Performance Analysis**: Big O notation, complexity comparisons, and optimization strategies
Expand Down Expand Up @@ -385,13 +379,12 @@ To add a new learning module (following the Next.js, Data Structures, and Big-O
2. **Define TypeScript interfaces** in `src/types/[module-name].ts`
3. **Create section components** in `src/sections/[module-name]/`
4. **Add 2D visualizations** in `src/components/models2d/[module-name]/`
5. **Add 3D visualizations** in `src/components/models3d/` (if needed)
6. **Create page component** in `src/pages/[ModuleName]Page.tsx`
7. **Create custom hooks** in `src/hooks/use[ModuleName].ts`
8. **Update theme colors** in `src/utils/theme.ts`
9. **Update navigation** in `src/components/Header.tsx` and `src/components/Sidebar.tsx`
10. **Add routing** in `src/App.tsx`
11. **Update README.md** with module information
5. **Create page component** in `src/pages/[ModuleName]Page.tsx`
6. **Create custom hooks** in `src/hooks/use[ModuleName].ts`
7. **Update theme colors** in `src/utils/theme.ts`
8. **Update navigation** in `src/components/Header.tsx` and `src/components/Sidebar.tsx`
9. **Add routing** in `src/App.tsx`
10. **Update README.md** with module information

## 🤝 Contributing

Expand Down Expand Up @@ -421,7 +414,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
## 🙏 Acknowledgments

- **Next.js Team** for the incredible App Router and modern React framework
- **Three.js** community for 3D visualization capabilities
- **React** team for the amazing framework ecosystem
- **Vite** for lightning-fast development experience
- **Tailwind CSS** for utility-first styling approach
Expand All @@ -443,21 +435,10 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file

_Transform your understanding of programming concepts through interactive visualization and hands-on learning. Master modern web development with our comprehensive Next.js, Git, JavaScript, RxJS, Data Structures, Big-O Notation, Python Programming, and AI Fundamentals modules. Practice algorithms with our LeetCode-style playground featuring advanced debugging, real-time visualizations, and gamification._

## 3D/2D Visualization Architecture
## Visualization Architecture

We use Three.js for 3D models with a modular structure under `src/three/`:
All visualizations use SVG-based 2D components organized under each feature module:

- `core/Engine.ts`: Lightweight host that creates a scene, camera, renderer, shared lights, and an animation loop. It manages model lifecycle.
- `core/types.ts`: `IModel` interface that all 3D models implement: `init(scene)`, `update(dt)`, `dispose()`.
- `core/anim.ts`: Tiny tween scheduler for simple time-based animations.
- `react/ThreeCanvas.tsx`: React bridge that mounts the engine in a div and registers provided models.
- `models/CallStackAssemblyLine.ts`: First model visualizing the Call Stack as an assembly line (conveyor + lift). Exposes `pushFrame()` and `popFrame()`.
- `models/python/PythonVM3D.ts`: 3D visualization of Python Virtual Machine internals and execution flow.
- `models/python/MemoryProfiler3D.ts`: Interactive 3D memory heap visualization with object allocation tracking.
- `models/python/CallGraph3D.ts`: 3D representation of Python function call relationships and execution paths.

Add a new model:

1. Create `src/three/models/MyModel.ts` implementing `IModel`.
2. Import it in a page and pass an instance to `ThreeCanvas` via `models={[new MyModel()]}`.
3. Expose imperative methods on your model (e.g., `step()`) and call them from UI buttons.
- Each feature's visualizations live in `src/features/[module]/components/visualizations/2d/`
- 2D components use React with SVG animations and CSS transitions
- Interactive controls (play/pause/step/reset) are built into each visualization component
4 changes: 1 addition & 3 deletions docs/ACTION-REQUIRED-REPOSITORY-ABOUT.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ The GitHub repository's **About section** needs to be updated with a proper desc

### Step 2: Copy This Description
```
Interactive programming education platform with 70+ visualizations covering Git, JavaScript, Next.js, Data Structures, Big-O, Python, and RxJS. Built with React, TypeScript, and Three.js for immersive learning experiences.
Interactive programming education platform with 70+ visualizations covering Git, JavaScript, Next.js, Data Structures, Big-O, Python, and RxJS. Built with React, TypeScript, and interactive 2D visualizations for engaging learning experiences.
```

### Step 3: Copy This Website URL
Expand All @@ -34,7 +34,6 @@ react
typescript
vite
tailwindcss
threejs
react-router
```

Expand All @@ -58,7 +57,6 @@ web-development
programming-tutorial
educational-content
2d-visualization
3d-visualization
leetcode
algorithm-visualization
code-playground
Expand Down
28 changes: 3 additions & 25 deletions docs/Big-O-Notation-Implementation-Plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

This comprehensive implementation plan outlines the development of an interactive Big-O Notation learning module for the Code Executives platform. Based on extensive research from the prepared document "Big-O Notation: Visualization and Optimization" and analysis of leading educational visualization platforms like Algorithm Visualizer, BigOCheatSheet, and Compigorithm, this plan provides a roadmap for creating engaging, interactive visualizations that transform complex algorithmic complexity concepts into accessible learning experiences.

The module will follow the established Code Executives architecture, utilizing React 19, TypeScript, SVG animations for 2D visualizations, and Three.js for 3D models, all styled with Tailwind CSS 4.x. The implementation will incorporate advanced interactive features including real-time complexity analysis, comparative algorithm visualization, and gamified learning elements to make Big-O notation both understandable and engaging.
The module will follow the established Code Executives architecture, utilizing React 19, TypeScript, and SVG animations for 2D visualizations, all styled with Tailwind CSS 4.x. The implementation will incorporate advanced interactive features including real-time complexity analysis, comparative algorithm visualization, and gamified learning elements to make Big-O notation both understandable and engaging.

---

Expand Down Expand Up @@ -72,11 +72,6 @@ src/
│ ├── RealWorldApplications.tsx
│ ├── AdvancedTopics.tsx
│ └── PracticeChallenges.tsx
└── three/
└── models/
├── ComplexityLandscape3D.ts
├── AlgorithmSpace3D.ts
└── PerformanceVisualization3D.ts
```

---
Expand Down Expand Up @@ -328,21 +323,6 @@ Based on research from educational platforms and cognitive science:
- **Optimization Suggestions**: AI-powered improvement recommendations
- **Challenge Mode**: Gamified complexity analysis exercises

### 3D Visualization Concepts

#### Use Cases for 3D Models

- **Complexity Landscape**: 3D terrain representing different complexity "valleys" and "mountains"
- **Algorithm Space**: 3D scatter plot of algorithms by time/space complexity
- **Performance Over Time**: 3D surface showing algorithm performance across input sizes
- **Optimization Pathways**: 3D paths showing algorithm improvement trajectories

#### 3D Model Guidelines

- **Educational Focus**: 3D should clarify, not complicate understanding
- **Performance Optimized**: Ensure smooth 60fps rendering
- **Fallback Support**: Provide 2D alternatives for lower-performance devices

---

## 🛠️ Technical Implementation Details
Expand Down Expand Up @@ -489,9 +469,8 @@ class ComplexityAnimationQueue {
- [ ] Create interactive algorithm simulator
- [ ] Add support for custom algorithm input

### Phase 4: Advanced Features and 3D (Week 7-8)
### Phase 4: Advanced Features (Week 7-8)

- [ ] Implement 3D complexity landscape visualization
- [ ] Add advanced topics (amortized analysis, NP-completeness)
- [ ] Create real-world application case studies
- [ ] Build practice challenge system
Expand Down Expand Up @@ -575,7 +554,6 @@ class ComplexityAnimationQueue {

### Component Reuse

- Extend ModeTabs for different visualization modes
- Use established patterns for control panels and animations
- Integrate with existing educational content structure

Expand Down Expand Up @@ -621,7 +599,7 @@ class ComplexityAnimationQueue {
- React 19 advanced patterns and performance optimization
- TypeScript for complex type definitions
- D3.js for advanced data visualizations
- Three.js performance optimization techniques
- SVG animation techniques

### Educational Research

Expand Down
27 changes: 2 additions & 25 deletions docs/Data-Structures-Implementation-Plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

This comprehensive implementation plan outlines the development of an interactive Data Structures learning module for the Code Executives platform. Based on extensive research from the prepared document "Understanding Computer Science Data Structures" and analysis of leading educational visualization platforms, this plan provides a roadmap for creating engaging, interactive visualizations that transform complex data structure concepts into accessible learning experiences.

The module will follow the established Code Executives architecture, utilizing React 19, TypeScript, SVG animations for 2D visualizations, and Three.js for 3D models, all styled with Tailwind CSS 4.x.
The module will follow the established Code Executives architecture, utilizing React 19, TypeScript, and SVG animations for 2D visualizations, all styled with Tailwind CSS 4.x.

---

Expand Down Expand Up @@ -73,12 +73,6 @@ src/
│ ├── ComplexityAnalysis.tsx
│ ├── RealWorldApplications.tsx
│ └── PracticeProblems.tsx
└── three/
└── models/
├── DataStructure3D.ts (base class)
├── Array3DModel.ts
├── Tree3DModel.ts
└── Graph3DModel.ts
```

---
Expand Down Expand Up @@ -357,21 +351,6 @@ array.splice(index, 0, newElement);
- **Drag and Drop**: Visual feedback during drag operations
- **Touch Support**: Mobile-friendly touch gestures

### 3D Visualization Concepts

#### Use Cases for 3D Models

- **Memory Heap Visualization**: 3D stack of memory blocks
- **Tree Structure Exploration**: 3D tree that can be rotated
- **Graph Network Visualization**: 3D node network for complex graphs
- **Performance Comparison**: 3D bar charts for Big-O analysis

#### 3D Model Guidelines

- **Performance First**: Optimize for smooth 60fps rendering
- **Educational Focus**: 3D should enhance understanding, not distract
- **Fallback Options**: Provide 2D alternatives for performance-constrained devices

---

## 🛠️ Technical Implementation Details
Expand Down Expand Up @@ -539,7 +518,7 @@ class AnimationQueue {
- [ ] Complete complexity analysis section
- [ ] Build real-world applications showcase
- [ ] Implement practice problems interface
- [ ] Add 3D visualizations for select concepts
- [ ] Add additional interactive features for select concepts

### Phase 7: Polish and Testing (Week 9)

Expand Down Expand Up @@ -618,7 +597,6 @@ class AnimationQueue {
### Component Reuse

- Leverage existing shared components where appropriate
- Extend ModeTabs for different visualization modes
- Use established patterns for control panels and animations

---
Expand Down Expand Up @@ -661,7 +639,6 @@ class AnimationQueue {

- React 19 documentation and best practices
- TypeScript advanced patterns
- Three.js performance optimization
- SVG animation techniques
- Tailwind CSS 4.x utility classes

Expand Down
10 changes: 4 additions & 6 deletions docs/GITHUB-REPOSITORY-ABOUT-SECTION.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ This document provides the recommended configuration for the **Code Executives**

**Short Description** (max 350 characters):
```
Interactive programming education platform with 70+ visualizations covering Git, JavaScript, Next.js, Data Structures, Big-O, Python, and RxJS. Built with React, TypeScript, and Three.js for immersive learning experiences.
Interactive programming education platform with 70+ visualizations covering Git, JavaScript, Next.js, Data Structures, Big-O, Python, and RxJS. Built with React, TypeScript, and interactive 2D visualizations for engaging learning experiences.
```

**Alternative Shorter Description** (max 160 characters):
Expand Down Expand Up @@ -34,7 +34,6 @@ Add the following topics to improve discoverability and SEO. Topics help users f
- `typescript`
- `vite`
- `tailwindcss`
- `threejs`
- `react-router`

### Content/Module Topics
Expand All @@ -54,7 +53,6 @@ Add the following topics to improve discoverability and SEO. Topics help users f
- `programming-tutorial`
- `educational-content`
- `2d-visualization`
- `3d-visualization`

### Additional Recommended Topics
- `leetcode`
Expand All @@ -81,7 +79,7 @@ Add the following topics to improve discoverability and SEO. Topics help users f
```bash
# Using GitHub CLI (gh)
gh repo edit mnaimfaizy/code-executives \
--description "Interactive programming education platform with 70+ visualizations covering Git, JavaScript, Next.js, Data Structures, Big-O, Python, and RxJS. Built with React, TypeScript, and Three.js for immersive learning experiences." \
--description "Interactive programming education platform with 70+ visualizations covering Git, JavaScript, Next.js, Data Structures, Big-O, Python, and RxJS. Built with React, TypeScript, and interactive 2D visualizations for engaging learning experiences." \
--homepage "https://codexecutives.com"

# Add topics (requires separate API calls or manual addition via web interface)
Expand Down Expand Up @@ -137,14 +135,14 @@ The About section should look similar to this:
📝 Description
Interactive programming education platform with 70+ visualizations covering Git,
JavaScript, Next.js, Data Structures, Big-O, Python, and RxJS. Built with React,
TypeScript, and Three.js for immersive learning experiences.
TypeScript, and interactive 2D visualizations for engaging learning experiences.

🌐 Website
https://codexecutives.com

🏷️ Topics
educational-platform interactive-learning programming-education react typescript
vite tailwindcss threejs git-tutorial javascript-engine data-structures
vite tailwindcss git-tutorial javascript-engine data-structures
algorithms nextjs python rxjs visualization web-development coding-education
learn-to-code programming-tutorial
```
Expand Down
Loading
Loading