# playground

**Repository Path**: opopi/playground

## Basic Information

- **Project Name**: playground
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# topheman-playground

[![Demo](https://img.shields.io/badge/demo-online-blue.svg)](https://topheman-playground.herokuapp.com/)

## Intro

Once you snapped the QR-code with your phone, take control of the bouncing ball on your desktop screen, like a Wiimote, tilting your phone as you would do on a labyrinth game.

* Connect with multiple mobile devices
* Watch from multiple desktop/laptop screens

Not a game, more of an experiment that could lead to a game …

**On your phone, you will likely need to enable "Motion and Orientation" in Settings > Safari (or chrome ...)**

![Topheman Playground](https://raw.github.com/topheman/playground/master/app/public/src/css/img/topheman-playground-bandeau.png)

## Install

```
yarn
```

## Run

For development:

```
npm run dev:https
```

This will start the nodejs server and launch and expose it via a secure tunnel on a public https url, thanks to ngrok.

This will be necessary for testing with the accelerometer on your mobile device since the related APIs only work on https.

For production:

```
npm start
```

## Previous versions

* [topheman/playground1](https://github.com/topheman/playground1): I made the very first version in 2012 to play with websockets on node (most like likely with some version of 0.8.x 😉)
* [topheman/playground2](https://github.com/topheman/playground2): started a little after the v1
    * it was testable on heroku
    * there was a feature that let you test the accelerometer in-browser with a ui (at the time we didn't have sensors in the devtools)
    * using requirejs
    * upgraded over the years up to node v6

Those previous versions are deprecated in favor of this one - [topheman/playground](https://github.com/topheman/playground). I upgraded some dependencies and patched the code so it would work with the latest version of node.

## Notes

When you'll browse the code, you'll see that there is a connection/disconnetion routine on the sockets which makes sure to disconnect any mobile client which has more than one socket opened (to prevent multiple dead balls). This was a tricky part, playing with the express session and the socket.io handshake :-) 

At the beginning of the year 2019, Apple started to block by default `devicemotion` and `deviceorientation` events on Safari. You still can enable them in the settings.

This is the reason I dove back into the code.

Presentation : [http://slid.es/topheman/topheman-playground](http://slid.es/topheman/topheman-playground)