Skip to content

cephalization/megawave

Repository files navigation

~~ MEGAWAVE ~~

Home screen image as of 3/16/2022

Development

Development is tested and supported on Linux, Mac OS, and WSL 2

The only barrier supporting native windows development is .env parsing and management.

Follow these steps to get a development environment setup (approximately 5-10 minutes).

  • (optional) Copy default vscode workspace setup for proper autocomplete and linting in python and javascript

    • cp .vscode.default .vscode

    • Install recommended extensions when prompted by vscode

  • Install api requirements

  • Install frontend requirements

  • cp .env.example .env

  • Configure music library path in .env

  • Run start-dev.sh

  • (optional) Run each app separately

    • Run api locally

      • The api server will automatically reload to reflect (most) code changes

      • Re-run command if dependencies change

    • Run frontend locally

      • The dev server will automatically reload to reflect code changes

      • Re-run command if dependencies change

Deployment

Megawave is still not completely production ready but it can run in a production-like environment pretty quickly with Docker.

  • Install Docker

  • cp .env.example .env

  • Configure music library path in .env

  • docker-compose up

  • Go to localhost