Skip to content

Turbo360

benloh edited this page Apr 9, 2025 · 9 revisions

Work in Progress

Overview

In general, you want to do this:

  1. Admin: Prepare a "NetCreate (Blank)" template
  2. Researcher: Clone a new "Unit" from "NetCreate (Blank)"
  3. Researcher/Teacher: Clone a new "Project" from the "Unit" T360 template
  4. Teacher: Share that "Project" with students

1. Admin: Prepare a "NetCreate (Blank)" template

There should already be a "NetCreate (Blank)" template project. If you need to prepare a new one (e.g. because the code needs to be updated) you would deploy a new version to the "NetCreate (Blank)" instance. Assuming you really do want a blank project, you should not need to add any nodes or edges.

2. Researcher: Clone a new "Unit" from "NetCreate (Blank)"

A "Unit" is really just a T360 Project that is set to be cloneable. To add starting nodes and edges to a project:

  • Import a new NC Template (toml file)
  • Import Nodes (from csv)
  • Import Edges (from csv)
  • Make the project cloneable

Important

Once a project is cloned it is difficult to modify, so prepare the "Unit" project carefully. Updating the code for a T360 Project instance is a time consuming manual process requiring a manual deployment of every project instance.

3. Researcher/Teacher: Clone a new "Project" from the "Unit" T360 template

To prepare a new project instance from the "Unit" T360 Template, launch a new project from the "Unit" T360 Template. If each classroom/period needs to have their own graph, launch multiple new projects.

4. Teacher: Share that "Project" with students

Generate tokens and share the tokens with students.




Steps

Assuming you have already set up a Turbo360 account...

Prep Turbo 360 account

  1. Launch a new project from a template

This will create a curriculum project instance. We will then deploy code changes on top of this instance. And then use this as the jumping off point for cloning additional projects for students.

a. Log in b. Click on "Templates" c. Find a template to use and click "Launch" -- e.g. "net.create (Blank)" d. Give it a name, e.g. "nc_curric_spring2025" -- you will be cloning b. Select "Can Clone"

Deploy

  1. git clone https://github.com/Vertex-Labs/netcreate-itest-turbo360.git
  2. cd netcreate-itest-turbo360
  3. git checkout turbo360-web-host
  4. nvm use
  5. npm ci
  6. Make sure it runs: ./nc.js --dataset=demo
  7. npm run package-turbo360
  8. Deploy: npm run deploy-turbo360
  9. Select the existing instance to deploy to.
  10. Get the URL from the portal: https://portal.turbo360.co/

Tips

{dataset: 'demo', port: '3000', googlea: '0'}

NOTES WIP

  • Project database files are in /app-data/ -- these are the files that will be deployed.
    • So to update that you have to run npm run package
    • How do you define which project is active? Use /.nc.js ? does netcreate-config.js show the right project?
  • Does this always start with a blank db? And you have to import data?

Clone this wiki locally