Native Git connects one local folder to one workspace. In this part you fork a ready-made service repo, create the workspace that will hold its collection, and connect the two so you get an editable Local View of your Postman elements sitting next to the code.
Fork the Template Repository
You'll work against the Deskly API, a small hot-desk booking service. Forking it gives you your own copy to push to, and cloning that fork gives Native Git a local folder to connect. Working from a fork keeps the original repo clean while your collection lands in version control next to the service code.
-
Go to the template repo: github.com/Postman-Devrel/deskly-api.
-
Click Fork (top right), keep the name
deskly-api, and create the fork under your own account. -
Make sure your fork is Public — LiftOff verifies it with unauthenticated GitHub API calls and never asks for a token. If it's private, open Settings → General → Danger Zone → Change visibility and set it to public.
-
Clone your fork to your machine:
git clone https://github.com/<your-username>/deskly-api.git cd deskly-api -
Enter your GitHub username below. LiftOff saves it so the rest of this module can check your repo and committed files automatically.
Note: The repo must be public for validation to work — a private repo returns 404 to unauthenticated reads.
Create Your Project Workspace
Native Git is scoped per service: one repo folder connects to one workspace. You're going to create that workspace now — it becomes the cloud counterpart of the folder you connect in the next step.
-
Open the Postman desktop app. Native Git is desktop-only — the Git-connected experience is not available in the web app.
-
Click Workspaces in the Postman header, then click Create.
-
On the Create your workspace form, name it exactly, replacing
[Your name]with your own name:[Your name] - Native Git -
For Who can access, open the dropdown and choose Only you and invited people — Internal is already selected.
-
Leave the template on Blank workspace (already selected), then click Create Workspace.
Once the workspace is connected to Git in the next step, it shows up under Workspaces → View all workspaces → Project Workspaces.
Connect a Local Folder
Connecting a folder is what gives the workspace a Local View — an editable, file-backed copy of your Postman elements sitting next to your application code. Connect the root of the repo you cloned so Postman can see both the collection and the service code.
- Open your [Your name] - Native Git workspace in the desktop app.
- From the Postman left sidebar, click Files.
- Click Open folder.
- Open the
deskly-apifolder you cloned in Step 1, then click Open. Its contents appear in the file tree view. - Click Connect to workspace. This is what links the folder to your workspace and creates the
.postmanandpostmanfolders in the repo.
Expected outcome: you can now switch between Local View and Cloud View using the control in the bottom left.
Caution: You can only connect one folder to one workspace at a time. To open your files in a different workspace, first disconnect: select File viewer options → Disconnect.