Mastero Projects
Last updated November 7, 2026
Mastero puts a project from your computer on GitHub in one step. Classgrid makes the repo, pushes your code and links the project, and from then on the same project works on your computer and in the Classgrid cloud. GitHub is the master copy that keeps the two in step.
What you need
Make a Mastero project
- Open your folder project in Studio.
- Open the Project tab and click Mastero.
- Check the GitHub account at the top. It shows your name and Connected. If it says "GitHub isn't connected", click Connect GitHub, finish signing in, then come back to the app.
- Check the Repo name. It starts as your folder's name, shown the way GitHub shows it:
your-login / name. Change it if you like. - Pick Private (only you can see it) or Public (anyone can see it). Private is picked by default.
- Click Make repo and push.
Classgrid then does three steps, ticked off as they finish:
When it's done you'll see "{name} is on GitHub" with the repo link. Click the copy button to copy the link, or Open on GitHub to see it.
A big folder can take a minute to push.
What is left out of GitHub
If your folder has no .gitignore file, Mastero adds one before the first push, so these never go to GitHub:
- Installed packages:
node_modules/,.venv/,venv/,__pycache__/ - Secrets:
.envand.env.*(an.env.examplefile still goes) - Build output:
dist/,build/,.next/,out/,.vercel/ - Logs and system files:
*.log,.DS_Store,Thumbs.db
If your folder already has a .gitignore, Mastero uses yours as it is.
If your project is already on GitHub
If the folder was already pushed to a GitHub repo, or the project is already linked to one, Mastero doesn't make a new repo and doesn't push anything. The window shows the repo it keeps (and the folder's Vercel project, if it was deployed with Vercel), and the button says Make Mastero project.
If that repo is already another one of your projects, Mastero stops and tells you to open that project instead, so the same code is never two projects.
After you click the button, the Mastero button leaves the Project tab: the rest happens in the chat.
Finish in the chat
Right after that, the agent takes over in the chat. It shows one Mastero card at a time, on top of the chat box:
- Name: the agent suggests a name for the project in Classgrid. Change it if you like and click Save.
- Photo (optional): click Upload photo, pick a picture and crop it. It becomes the project's logo. Or click Skip.
- Finish: click Finish to make it a Mastero project.
Each card saves your answer straight away. Click Cancel on any card to stop there; the agent asks you once if you want to try again.
Your project becomes a Mastero project only when you click Finish. Before that, nothing changes: no Push button, no Mastero section, no automatic pushes. After Finish, the agent explains in a few simple lines what changed, with links to these docs.
Where Mastero projects show
Continue a chat online
After Finish, the Project tab in the desktop app shows Continue online with a QR code for the chat you have open.
- Scan the QR code with your phone to open that chat on chat.classgrid.in.
- Or click copy link (or the QR code) to see it bigger, then copy the link to open it on another computer.
A chat from the desktop app stays only in the app until you do one of these yourself. Once you open or copy it, it shows on chat.classgrid.in too, in its project.
Pushing changes
GitHub is the master copy, so a Mastero project's changes go to GitHub.
Change it in Settings → Mastero.
You can also push yourself: in the Project tab, click Push, type what changed, and click Push. Your commit message is used exactly as you typed it.
Where the push goes:
- From your computer: to your folder's own branch (
mainfor a new repo). - From the cloud: to a
classgrid/branch with a pull request that you merge on GitHub. See Pull requests and backups. Your computer gets those changes the next time you pull.
Undo a change
GitHub's history is never rewritten: no change is ever deleted from it, so you can always see what was changed and what was taken back.
Where your code runs
To use a Mastero project in the cloud (on chat.classgrid.in or your phone), install the Classgrid GitHub app on its repo: on the Projects page, click Install app. See Connect GitHub.
Your code in the cloud
The cloud keeps your code only while you use it:
- It leaves the server 5 minutes after the code editor closes, or after 30 minutes without use in Studio.
- Anything not pushed yet is saved to a
classgrid-backup-…branch on GitHub first. - The next time you open the project in the cloud, the newest code downloads fresh from GitHub.
Go live
A Mastero project can go live on your own Vercel account. Ask the agent, for example "Deploy this to Vercel." See Deploy with Vercel. Pushing to GitHub never deploys by itself.
