The Distributed Open Education Network (Doenet) is an open data-driven educational technology platform designed to measure and share student interactions with web pages. It includes tools for authoring interactive educational content, including our custom DoenetML markup language, and conducting educational research using the content. Our ultimate goal is to provide research-based tools to help instructors and learners discover the most effective content. Simply put, Doenet gives teachers complete flexibility over their educational content and gives them power of anonymized student data to track learning outcomes. With Doenet, we hope to help teachers teach better and students learn better.
Although we are still in the early stages, we are excited to introduce Doenet and illustrate the richly interactive activities that one can author with it.
For more background and information on the Doenet project, see this MAA DUE Point article.
We would love to hear from you! Join our Discord to ask questions and stay updated on our progress!
Doenet is built using React and bundled for the web using Snowpack. Data for Doenet is stored in MySQL tables and components have been tested in Cypress. We use Docker to ship and run Doenet and our container uses Apache, Snowpack, PHP, MySQL, and RTNode. For reference, the container is set up to use port 80 for the local Downet website, port 8080 for the build site, and port 3306 for MySQL. You may have to change the ports used on your local device.
Doenet is open-source so that instructors and learners can customize it to best serve their needs. To start developing:
-
Fork the DoenetTools repository.
To enable the v2 docker compose CLI on Linux, install the docker-compose-plugin.
-
Open the repository and run
npm installto install all modules used by Doenet. -
To start your local version of Doenet, run
npm startand view it in the browser at http://localhost:80.
- If you are working with databases, we recommend installing Sequel Ace on MacOS or MySQL Workbench on Windows and Linux.
Creates and starts the Docker container and runs the app in development mode. Open http://localhost:80 to view it in the browser.
The page will reload if you make edits. You will also see any lint errors in the console.
Stops and removes the Docker container created by docker compose up.
While switching between branches, it is good practice to docker compose down and then docker compose up to view the correct version of the development site.
Starts the MySQL database.
Resets the MySQL database. Running this command often fixes minor database loading issues.
Takes the current local database and replaces the default one in the project to propagate database changes for the local code developers.
Builds a static copy of your site to the build/ folder.
Your app is ready to be deployed!
For the best production performance: Add a build bundler plugin like "@snowpack/plugin-webpack" to your snowpack.config.js config file.
Launches the application test runner.
Run with the --watch flag (npm test -- --watch) to run in interactive watch mode.
- Can not find the
doenet_localdatabase- run
npm create:dband thennpm reset:db
- run
- esbuild fails to install
- move to a node version
17.4or higher
- move to a node version
- cypress does not run
- run
npm installon your local machine first
- run
- dev container crashes due to cypress error
- make sure you have placed all cypress related dependencies in the optional category with
--save-optional
- make sure you have placed all cypress related dependencies in the optional category with
- course creation or other basic functions are not working after an update
- run
npm reset:db
- run
Run npm create:db and then npm reset:db.
Move to a node version 17.4 or higher.
Remember to run npm install on your local machine.
Make sure all cypress related dependencies have been placed in the optional category with --save-optional tag.
Run npm reset:db.