Skip to content

alphaonelabs/botlab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Alpha One Labs — Virtual Robotics Playground

A browser-based virtual robotics simulation environment for building, configuring, and testing autonomous mobile robots with real-time physics and sensor telemetry — no installation required.


🚀 Features

  • Modular Robot Builder — Start from a blank chassis and attach sensors, wheels, and a manipulator arm.
  • Omni-Directional Movement — Drive your robot with WASD or Arrow keys; adjust motor power and turning speed in real-time.
  • LiDAR Scanning — A rotating 360° LiDAR sensor casts a detection beam. When it passes over an object, the Detection Panel reports the object's shape and color.
  • First-Person Camera — Live FPV camera feed rendered from the robot's perspective directly in the browser.
  • Robotic Arm — Pick up and drop coloured blocks using the SPACE key.
  • Telemetry HUD — Real-time position, heading, and speed readout overlaid on the simulation canvas.

🛠️ Getting Started

No build tools or server required — just open the files directly in your browser.

  1. Clone the repository:
    git clone https://github.com/alphaonelabs/alphaonelabs-virtual-robotics-playground.git
  2. Open index.html in any modern web browser to view the landing page.
  3. Click Enter System to launch the interactive playground (home.html).

🎮 Controls

Key / Action Function
W / Move forward
S / Move backward
A / Turn left
D / Turn right
SPACE Pick up / Drop block (requires Arm)

🧩 Robot Components

Add or remove components from the Toolbox panel on the left:

Component Description
Chassis Core robot body — must be added before any other part
Wheels (WASD) Enables keyboard-driven movement
LiDAR Rotating laser scanner; detects nearby objects and reports shape & color
Camera (View) First-person camera feed shown in the top-left overlay
Arm (SPACE) Allows picking up and dropping blocks with the SPACE key

📡 LiDAR Detection

When the LiDAR sensor is active, its beam sweeps 360° around the robot. When the beam intersects an object within range, the Detection Panel (bottom of the right sidebar) instantly displays:

  • The shape of the detected object — Square, Circle, or Triangle
  • The color of the detected object — e.g. Red, Orange, Green, Blue

⚙️ Settings (Right Sidebar)

Setting Description
Power Motor power level (10 % – 100 %)
Turn Turning speed (1° – 15°)
Color Chassis colour picker

The Parts section shows all currently attached components, and Blocks displays the number of interactive objects in the simulation.


🎨 Tech Stack

  • Pure HTML5/CSS3/JavaScript — No frameworks required for the simulator
  • React 18 — Landing page animations (CDN)
  • Tailwind CSS — Utility-first styling (CDN)
  • GSAP 3.12 — Smooth scroll animations (CDN)
  • Canvas API — Real-time 2D graphics rendering

🌐 Browser Support

Browser Version Status
Chrome 90+ ✅ Fully Supported
Firefox 88+ ✅ Fully Supported
Safari 14+ ✅ Fully Supported
Edge 90+ ✅ Fully Supported

🗂️ Project Structure

alphaonelabs-virtual-robotics-playground/
├── index.html              # Landing page with animations
├── home.html               # Main robotics simulator
├── README.md               # This file
├── CONTRIBUTING.md         # Contribution guidelines
├── LICENSE                 # MIT License
└── .github/
    └── workflows/
        ├── deploy.yml      # GitHub Pages deployment
        └── pr-check.yml    # PR validation

🤝 Contributing

Contributions, bug reports, and feature requests are welcome!

  1. Fork this repository
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Commit your changes: git commit -m 'Add your feature'
  4. Push to your fork: git push origin feature/your-feature-name
  5. Open a Pull Request against main

Please read CONTRIBUTING.md for detailed guidelines and open an issue first to discuss major changes before starting work.


🗺️ Roadmap

  • Save/Load robot configurations
  • Obstacle course challenges with scoring
  • Autonomous robot programming interface
  • Multiplayer support (WebRTC)
  • 3D rendering with Three.js
  • Mobile touch controls
  • Export simulation data (CSV/JSON)

📄 License

This project is licensed under the MIT License.


Built by Alpha One Labs — Advancing open science through education and robotics.

About

Virtual Robotics Playground

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages