Mini Lab – Interactive Programming Learning Lab

An interactive learning platform used by the ByteProgramming to introduce new students to real programming concepts through visual experimentation.

🎯 About

Mini Lab is an interactive web platform designed for students who are starting their first semester in engineering and related programs. Its purpose is to provide a friendly, visual and intuitive first contact with the fundamental concepts of programming.

Unlike traditional teaching environments, Mini Lab allows students to modify real code fragments and immediately see the effect of their changes in a visual environment, strengthening the understanding of the relationship between code and result.

Mini Lab is also used as a showcase platform for the research and development “Semillero”, allowing new students to experience the type of projects, technologies and learning paths they can explore by joining the group.

🛠️ Technologies

• JavaScript
• React + Vite
• TailwindCSS
• Docker + Nginx
• npm

🚀 Getting Started

Note: This project uses Docker for all development and deployment. Make sure you have Docker installed on your machine.

Prerequisites

Before you begin, ensure you have Docker installed:

• Docker - Latest version
• Docker Compose - Usually included with Docker Desktop

Installation

1. Clone the repository

   git clone https://github.com/ByteProgramming1/mini-interactive-lab.git

   cd mini-interactive-lab

🏃 Running the Project

Development Mode

To run the project in development mode with hot-reloading:

• Start services:

  docker-compose up

• Or run in background:

  docker-compose up -d

• View logs:

  docker-compose logs -f

The application will be available at: http://localhost:8080

Useful Development Commands:

• Stop all services:

  docker-compose down

• Restart services:

  docker-compose restart

• Access container shell:

  docker-compose exec app bash

• View running containers:

  docker-compose ps

Production Mode

This is called docker-compose.yml:

• Start production environment:

  docker-compose -f docker-compose.yml up -d

• Check status:

  docker-compose -f docker-compose.yml ps

• Stop production environment:

  docker-compose -f docker-compose.yml down

🤝 Contributing

⚠️ IMPORTANT: This project follows strict contribution guidelines. All contributions MUST comply with the rules specified in CONTRIBUTING.md. Pull requests that do not follow these guidelines will be rejected.

This is a ByteProgramming project, and we maintain high code quality standards. Please read our Contributing Guidelines for detailed information on:

• 📝 Code style and conventions
• 💬 Commit message format
• 🌿 Branch naming conventions
• 🔍 Pull request requirements
• ✅ Testing requirements
• 🔧 Development workflow

Non-compliance with CONTRIBUTING.md will result in PR rejection.

📄 License

This project is private and belongs to Byte Semillero. All rights reserved.

All Thanks To Our Team Members 🚀

Current team members working on this project: