TeXposit can connect a project to a folder on your computer. There are two kinds of connection, and they differ in which side is the source of truth.

Browser support

Folder access uses your browser's File System Access API. It works in Chrome, Edge and Safari. Firefox is not supported, and the folder options show a message pointing you to another browser.

Two kinds of project

TeXposit project with a copy on your computer. The files live on TeXposit with full version history and provenance. Every save is also written to your folder. Edits you make directly in the folder are ignored, so the folder is a mirror, not an input.

Local project. Your folder is the source of truth. TeXposit keeps a copy so it can compile and share the project. A local project has no version history and no provenance report, and it cannot be linked to GitHub.

For a local project, changes flow both ways. TeXposit rescans the folder every 30 seconds and when you return to the browser window, and uploads what changed. Deleting a file in the folder is not detected.

Start a project

New project: in the new project dialog, under Where the files live, choose TeXposit + copy on this computer or Folder on this computer, then Choose folder.
Existing folder: on the projects page click Open Local and pick a folder. TeXposit creates a local project from its files.
Existing project: open File, then Project Settings, and in the Local folder section click Link folder. Linking sends the folder's current files to the project, so pick an empty folder or one that already holds this project's files. Unlink ends the connection.

Status in the editor

A Local indicator in the status bar shows the link:

Green: linked and synced. Hover to see the folder and the last sync time.
Amber: the browser lost access to the folder, for example after a restart. Click it, then Reconnect.
Amber with a count: files have conflicts, see below.

What is synced

Synced: .tex, .md, .bib and other text files, and images (.png, .jpg, .jpeg, .gif, .bmp, .tiff, .webp, .eps, .ps, .svg).
Skipped: LaTeX build output (.aux, .log, .bbl, .blg, .out, .toc, .lof, .lot, .fls, .fdb_latexmk, .bcf, .run.xml, .synctex.gz), compiled and binary files (.pdf, .dvi, .woff, .woff2, .ttf, .otf, .zip), and the folders .git, node_modules, output and __pycache__.

Conflicts

In a local project, a file can change both in your folder and on TeXposit between syncs, for example when a collaborator edits it in the browser. TeXposit does not overwrite either side. The status indicator shows the number of conflicts. Click it to compare the two versions and choose Use local version or Use TeXposit version.

Compiling

Compilation always runs in TeXposit. Edit in your own editor, save, and compile in the browser.

Deleting a project

Deleting a linked project never changes or deletes the files in your folder.