Gigantum

The Gigantum User Hub

Welcome to the Gigantum user hub. You'll find comprehensive guides and documentation to help you start working with the Gigantum platform as quickly as possible. If you get stuck, then there is help for that too.

Let's get to it!

Get Started    

Share a Project using the Gigantum Cloud

If you've never published a Project before, you should read all of this page.

You can share work in two ways. The easiest way is to publish a Project to Gigantum Cloud, but you can also export a Project as a file and then send it to people. This method removes Gigantum Cloud from the loop.

Publishing a Project

Publishing a project has several benefits including:

  • Simple collaboration and sharing with other users
  • Easy to share a project between your own devices
  • Remote project back up

Currently a project can be published either publicly or privately:

  • Public : Anyone can access a read only version of your project by finding it in Gigantum Explore or by having the import URL.

  • Private : Only collaborators may access your projects.

To share a Project just make click the Publish button in the toolbar at the top of the project menu and then choose to publish Publicly or Privately.

Publishing a Project is done with the Actions widget, but the Project must be stopped first.

Publishing a Project is done with the Actions widget, but the Project must be stopped first.

Once it is published, you will get a URL that other people can use to download your Project. The link is available in the Actions menu.

Publishing Limitations

Currently, free accounts are limited to 25GB of total storage. You may experience long sync times for large Projects, as uploading and downloading data is dependent on your internet connection.

Managing Collaborators

Currently, you can only add Collaborators individually, but in the future you'll be able to create Teams and apply more granular permissions.

To add a Collaborator:

  1. Click Collaborators button in the top left corner to bring up the Manage Collaborators window
  2. Start typing the user's name, username, or email and select the user from the auto-complete widget. Alternatively enter the username directly
  3. Select the desired permissions of the collaborator using the drop down menu. Currently the permissions are as follows:
  4. Read - Read only permission. Can only pull updates.
  5. Write- Read permissions, plus can sync to branches other than the master branch.
  6. Admin- Write permissions, plus can sync to master branch and manage collaborators.
  7. Click the "+" button to add the user as a Collaborator

Once added, the Project will show up in the user's Cloud View the Gigantum Client. You can also share the Project URL (accessible from the Actions menu) that the Collaborator can use to import the Project.

Syncing a Project

Once a Project is published, you can "sync" changes at any time. The sync operation first downloads any changes you don't have locally, merges those with your copy of the Project, and then uploads your changes.

If a merge conflict occurs that cannot be automatically resolved, you will be prompted to "Force Sync". This operation will overwrite any conflicted files with the version from the server. You can always recover your version by rolling back in the activity feed if desired. Future releases will provide a better managed merge experience.

Importing a Project from the Gigantum Cloud

If a Project has been shared with you as a collaborator, it will appear in the "Cloud" tab in the Projects overview (reached via the sidebar in the Gigantum Client). Each Project will have a Cloud icon with a check-mark for imported Projects, and a down-arrow to begin import and build of a Project. Currently, this will link to your collaborator's Project and any sync actions will update that original Project.

Importing a project from the Gigantum cloud

Importing a project from the Gigantum cloud

If you are working with a public Project, use the "Add Project" card on the "Local" Projects tab, and enter the link to the Project you've obtained from your collaborator or from the explore page.

If you Import a Project from a file, this will always create a copy, and no changes will be synced with the original.

Importing a public project using a URL

Importing a public project using a URL

Share a Project using the Gigantum Cloud


If you've never published a Project before, you should read all of this page.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.