Math3d-next

Math3d is a web-based, 3d math visualization tool—an online 3d graphing calculator.

The repository represents the next generation of math3d, the current source code for which is at https://github.com/ChristopherChudzicki/math3d-react.

Development

Prerequisites

The math3d backend and database are managed by docker containers. The frontend is not currently containerized. You'll need:

• Yarn, our JS package manager
• nvm, for managing node versions
• Docker, for containerization during development
• pre-commit, a framework for running pre-commit hooks

• Environment Variables: Additionally, you'll want some way to load environment variables for the frontend, which currently runs on the host machine. We recommend using direnv, which a .envrc file along the lines of

  dotenv_if_exists .env.development # committed in repo
  dotenv_if_exists .env             # customizations

Webserver Commands

Note The commands below should be run in a webserver container, e.g., via

# one-off
docker compose run --rm webserver <COMMAND>
# run commands in docker shell
docker compose run --rm webserver bash

See webserver/Makefile for more make commands.