GitHub Integration
A Meno project is an ordinary Astro codebase: .astro files under src/pages/ and src/components/, JSON content collections under src/content/, plus project.config.json, colors.json, and variables.json. Because that is all real source on disk, a Meno project is also a normal Git repository — so it works naturally with GitHub. You get version history, branches, pull requests, and collaboration with the exact same tools your team already uses.
Connecting GitHub also lets you commit and push directly from Meno, create repos as you create projects, and wire up Git-based deploys.
Connecting GitHub
If you have not connected yet, you will see a Connect GitHub prompt in the User menu (top right of the dashboard).
Click the User menu, then Connect GitHub.
A browser window opens for GitHub authorization. Meno copies a device code to your clipboard — paste it when GitHub asks.
Choose the organizations you want to connect, then click Authorize (confirm with two-factor if you have it enabled).
Return to the app.
Once connected, your GitHub username and avatar appear in the User menu, and your GitHub organizations populate the org switcher. A Join button appears next to New in the project area.
Committing and pushing from Meno
When a project is linked to a repo, Meno commits your saved changes and pushes them to GitHub for you — no terminal required. Every visual edit lands as a real change to the underlying .astro and JSON files, so each commit is a normal, reviewable change to the source tree.
Because the source is genuine Astro, the diffs are readable. A styling tweak shows up as a change inside a style({...}) call; a new section shows up as added .astro markup; a content edit shows up as a change to a JSON file under src/content/. Pull requests review cleanly, and you can leave comments on specific lines just like any other code review.
Collaboration and hand-editing
Two people can work on the same project the way they would on any Git repo. Use branches and pull requests to review and merge work, and resolve conflicts with your usual tools.
Editing stays in sync both directions. A teammate can pull the repo, hand-edit a .astro file in their own editor, and push — and those changes round-trip cleanly back into the Meno editor, as long as the hand-edits stay inside the meno-astro dialect. Likewise, anything you change visually in Meno shows up as a clean commit your teammates can read.
Joining a project
Click Join to open a browser of the GitHub repositories for the selected organization. Search or scroll to the repo you want, then click it to join. The project clones into your projects directory and appears in your dashboard grid, ready to collaborate on.
A joined repo must be a valid Meno project — it needs project.config.json and an src/pages/ directory. If the repo is not a Meno project, you will see an error.
Creating a project with a repo
When you select a GitHub organization and click New, Meno creates the project locally and creates a matching repo under that organization, then pushes the initial commit. For personal accounts, the repo is created under your GitHub username. For local-only organizations, the project is created on your machine without a repo.
Opening a project on GitHub
For any project linked to a repo, open the three-dot menu on its project card and click Open on GitHub to jump straight to the repository in your browser.
Deploys
Because the repo holds a runnable Astro codebase, you can connect it to any Git-based host (such as Netlify or Cloudflare Pages) so every push triggers a build of your static site. See deployment for the full setup.
Organizations and licensing
GitHub organizations map to Meno organizations: repos created under an org belong to that org, and org membership drives who can join and edit those projects. Org-level access ties into team licensing — seats and tier limits are managed per organization.
Disconnecting
To disconnect, open the User menu and click Disconnect. Your local projects stay exactly where they are. GitHub features — Join, org sync, repo links, commit and push — are disabled until you reconnect.
Related: Dashboard, Organizations, Licensing.