File Storage

The files are stored on each device along with versioning information by following convention over configuration principle.

Working Tree

Similar with Git terminology, the working tree contains the current image of the files stored in Teamshare, as seen by the user.

The absolute path of each file from the working tree is composed of three paths as follows:

${TEAMSHARE_PATH}/${TEAM_PATH}/${FILE_PATH}

where:

• ${TEAMSHARE_PATH}
  • absolute folder path where Teamshare files are stored, which is mounted after the user authenticates.
  • Defaults to ${HOME}/Teamshare/ (eg. /home/calinburloiu/Teamshare or C:\Users\calinburloiu\Teamshare).
• ${TEAM_PATH}
  • folder path relative to ${TEAMSHARE_PATH} where files shared by a team are stored.
  • Each team has its own ${TEAM_PATH}.
  • Defaults to the team name, but a user has the freedom to rename it locally. No other user must know the local name.
• ${FILE_PATH}
  • file path relative to ${TEAM_PATH} where the checked out revision of a file is stored.
  • Each file from a team has a ${FILE_PATH}.
  • Any rename / move of the file inside ${TEAM_PATH} will be synced with other devices from the team.

Configuration Files

Teamshare Configuration Folder

In ${TEAMSHARE_PATH} there is a hidden folder named .teamshare which stores configuration files for the user device.

Team Configuration Folder

For each team in its ${TEAM_PATH} there is a hidden folder .team which stores configuration files for that team, specific for that user device. Here, in revs folder the diffs to each file are stored.