https://github.com/code-dot-org/dance-party
Renderer for the Dance game type. Based on p5.js and p5.play.js.
https://github.com/code-dot-org/dance-party
Last synced: 8 days ago
JSON representation
Renderer for the Dance game type. Based on p5.js and p5.play.js.
- Host: GitHub
- URL: https://github.com/code-dot-org/dance-party
- Owner: code-dot-org
- Created: 2018-10-09T16:23:51.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2025-11-15T04:25:56.000Z (2 months ago)
- Last Synced: 2025-11-15T05:43:07.033Z (2 months ago)
- Language: JavaScript
- Homepage: https://code-dot-org.github.io/dance-party/
- Size: 68.8 MB
- Stars: 14
- Watchers: 21
- Forks: 15
- Open Issues: 90
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dance Party
[](https://github.com/code-dot-org/dance-party/actions/workflows/build.yml)
[](https://codecov.io/gh/code-dot-org/dance-party)
Steps to get up and running
```
git clone git@github.com:code-dot-org/dance-party.git
cd dance-party
nvm install
nvm use
yarn
yarn run dev
```
At this point the app will be running at localhost:8080. Open the developer tools in Chrome and you can access the API via `nativeAPI.*`
If you want to make changes locally in dance-party and have them show up in your apps build, do the following:
- In the `code-dot-org/apps` directory, run `yarn link `
For example if your `dance-party` and `code-dot-org` projects are stored in your root directory, you would run `yarn link ~/dance-party`.
Note that there will be local changes in `package.json` and `yarn.lock` that you want to make sure you don't commit.
To debug unit tests in the Chrome debugger:
`node --inspect --debug-brk ./node_modules/.bin/tape ./test/unit/*.js`
Open [chrome://inspect](chrome://inspect) in Chrome browser (requires Chrome 55+)
Tap on `inspect` link under "Remote Target"
### Additional build notes
Node 14.17.1 or higher should be used. This can be achieved by running:
```
nvm use v14.17.1
```
It also appears that Python 2.7 should be used and must be available for installing `node-gyp`. Techniques may vary, but this worked in one situation:
```
apt-get install python2.7
ln -s /usr/bin/python2.7 /usr/bin/python
```
### Adding New Characters
To add a new character to Dance Party, follow the instructions here: https://github.com/code-dot-org/dance-spritesheets to create the spritesheet for the character.
### Effects Testing
`yarn run test:visual` uses [pixelmatch](https://github.com/mapbox/pixelmatch#readme) to test for consistency in screenshots between your local branch and an accepted
baseline. Accepted baselines are saved in `test/visual/fixtures`.
To debug a test failure, run `node ./test/visual/helpers/generateScreenshot.js `
to output the local screenshot to the given directory. If a baseline does not exist for a given effect, the screenshot
from your local branch is saved as the baseline. Effects are drawn with no characters on the screen so effects appear
the same when drawn as backgrounds or foregrounds.
#### To Add Test Coverage For a New Effects
Add the name of the effect to the list of effects in `backgrounds.js`. Run `yarn run test:visual`.
After a new baseline is generated, manually inspect it to ensure it matches expectations.
#### To Update A Baseline
Delete the accepted baseline. Run `yarn run test:visual`. After a new baseline is generated, manually inspect
it to ensure it matches expectations.
### Publishing a new version
First, ensure you have the `main` branch checked out locally, and that it's up to date.
To publish a new version, the following command should work:
```
yarn version 1.0.4
```
With `1.0.4` replaced by the new version number that should be published.
Note: make sure you are logged into `npm` first. If not, the command may fail with a misleading `E404` error. You can see if you're logged in with `yarn npm whoami`, and if not logged in, can can use `yarn npm login`.