The Notio Project

The Notio Project focuses on developing new pedagogies and technologies for improving the teaching of music theory together within the creative music practices of songwriting and improvisation to improve music education in schools in Finland. This project is funded as a Bridging the Theory and Practice of Music through Educational Research and Technology research grant from the Åbo Academy University Foundation (Finland). The MusEDLab is collaborating with PI Cecilia Björk (Åbo Academy), Mats Granfors (Novia University of Applied Sciences), and Jan Jansson (Vasa Övningsskola).

License

This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Detailed info about Notio here

[Notio hosted at Netlify. 2023 here

You can see the project here. 2019 dev of project

Install packages

yarn install

Run dev version

npm start or yarn start

Build

• yarn build
• npx serve -s build

To deplot to Github Pages

• yarn deploy. This will also make a build for you.

The code is formatted with the Prettier plugin.

-tab size 2 -allow double and single quotes

Testing

Notio follows constitutional testing principles (v2.0.0) with integration-first testing:

• Integration Tests: 60-70% of test suite (PRIMARY)
• E2E Tests: 20-30% of test suite (SECONDARY)
• Unit Tests: 10-20% of test suite (MINIMAL - edge cases only)

Run Tests

# Integration and unit tests
yarn test                    # Run all tests in watch mode
yarn test --coverage        # Generate coverage report (100% required)
yarn test:a11y              # Run accessibility tests

# E2E tests (Playwright)
yarn test:e2e               # Run in all browsers
yarn test:e2e:headed        # Run with visible browser
yarn test:e2e:debug         # Run with Playwright Inspector

Documentation

• Testing Guide - Complete testing documentation
• Constitutional Quickstart - Copy-paste test templates
• Constitution v2.0.0 - Core development principles

All tests must pass with 100% code coverage before merging.

Info to developers

use nvm to install the latest node-version found int the .nvmrc file if nvm is not installed run: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | zsh

-close and reopen terminal then to verify run: nvm --version

-find latest version of node(Erbium): nvm ls-remote

-install latest version: nvm install [version.number]

run : yarn

Yarn Packages:

##needed to run topMenu: react-tooltip
react-draggable react-bootstrap
react-player

firebase @react-firebase/database

react-router-dom v6