Connect a project and choose defaults
Connect a project to reuse its folder in the launcher, choose a default toolkit, or launch it from the web app. You can still launch locally in an unconnected folder using the workspace default.
Before you start
Section titled “Before you start”Connect your computer. Have the project folder on that computer. A project can be a plain folder; it does not need a Git repository.
Connect one folder in the desktop app
Section titled “Connect one folder in the desktop app”- Open Code Config and choose Add local project.
- Enter the folder path or choose Browse… and select the project folder.
- Choose Add. The folder is not saved until you do.
To add several projects, choose Scan for projects during setup or Settings → Sync projects later. Choose the parent folder, select the projects from the results, and confirm. The scan does not add projects before you confirm.
Connect from the web app
Section titled “Connect from the web app”Open Projects → Map project. Choose a GitHub repository or a local folder. For a local folder, choose the computer and complete the folder selection in Code Config on that computer.
Each computer confirms its own folder. Connecting a repository in the web app does not clone it onto every computer.
Set a default toolkit
Section titled “Set a default toolkit”Open the project in Projects and set Default toolkit. This applies when you launch that project without selecting another toolkit. Leave it unset to use the workspace default.
Changing the project’s default does not prevent a one-time choice. Toolkit selection order explains the complete order.
From the terminal
Section titled “From the terminal”In the project folder, connect it and set its default:
csc project set --toolkit <toolkit-id>Replace <toolkit-id> with the toolkit’s ID, not its display name. Use the command-line reference to list available toolkits and inspect commands supported by your build.
To connect another local folder, add --path <path>. If a repository is not on this computer, clone it with Git first and connect the folder it creates.
Check it worked
Section titled “Check it worked”The project appears in Projects. Its toolkit’s Usage tab lists the project as a default user. Before launching, confirm Code Config shows the toolkit you chose, with project default as the source.
The web app tracks project and computer identities. Readable folder locations and ordinary project files remain on the computer.
Launch from the web app, or open the project from Code Config on your computer.