Module 1 of 4 in Native Git in Postman
Learn Native Git, where Postman stores collections as files in your Git repo. You fork and run the small Deskly API, build a collection for it in Local View, and push it to GitHub.
- You'll build
- A Deskly API collection saved as files in your GitHub fork, on a feature branch.
- Time
- About 30 min · 3 parts · 6 steps · progress saves as you go
- How it works
- You do each step, then click Validate and LiftOff checks your work. 3 of the 6 steps can't be checked automatically, so you click Done for those.
- You'll need
- A free Postman account and API key (connect it below)
- A few setup steps, shown below before you start
Connect a Postman API key to check your work
You do each step in Postman, then LiftOff uses your key to look at your workspace and confirm it's done. Connect once and it works for every module. Your key is saved in this browser and is only used to check your work in Postman.
Before you start
Native Git requires the Postman desktop app — the Git-connected experience is not available in the web app. Download Postman and sign in first.
You'll also need:
- Git installed locally.
- Node.js 18+ — the Deskly API you'll run locally is a small Node.js/Express service.
- A GitHub account so you can fork the template repo and push to it.
Connect a Forked Git Repo to a Workspace
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.
Run the API and Build a Collection
Deskly is a runnable service, so you'll start it on your own machine and build a collection that actually calls it. Because you author the collection in Local View, every request is written to files under postman/ in your repo — ready to push in Part 3.
Push Your Changes with the Postman Terminal
Your collection now lives as files in the repo. Push them to a feature branch on your fork — that's all LiftOff needs. You do not need to open a pull request, merge anything, or contribute back to the source repo.