Getting Started
Linking Repositories
Learn how to import your existing Astro projects into the platform. The process is fast and preserves the integrity of your code.
How the process works
1. Automatic Detection
The system scans your connected repositories for a defined src/content folder. If we detect a valid Astro project, we will mark it as "Compatible".
2. Initial Import
When you click "Import", we clone a shallow reference of your repository and cache your .md and .mdx files. This usually takes 2 to 10 seconds.
3. Filtering (Optional)
By default, we import all content. You can use a .cmsignore file (beta feature) to exclude specific folders.
Troubleshooting
I can't see my repository
Make sure you have granted permissions to the GitHub App. Go to Settings on GitHub and check the "Applications" section.
Parsing error
If your config.ts uses very complex or dynamic functions, the static parser might fail. Try simplifying the collection definitions.