Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Latest commit

 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages