GitHub Sync

This plugin connects your GitHub Markdown content to your Framer CMS, simplifying website updates. It syncs all .md files from a designated GitHub repository folder to a Framer CMS collection.

Frontmatter

Use front matter to add custom fields to your content, front matter is a section at the top of your markdown files that is defined in YAML and delimited by --- characters.

These front matter fields will be available in your Framer collection after importing.

Markdown Rendering

The plugin will add Markdown (.md) files to your Framer CMS collection, preserving formatting and markdown semantics. This plugin will also work with .mdx files but custom react components and JavaScript code will be discarded.

Importing files inside a base path

Specify a base path within your repository to target specific folders for syncing. This allows you to organize your Markdown content and selectively sync portions to different Framer collections.

Relative Images and Links

Relative image and file paths are resolved by searching the entire repository for a matching file. For example, if your Markdown file contains , the plugin will search for image.png within the same directory as the Markdown file. It also checks for matches in other directories within the repository, handling cases where the path might be slightly different (e.g., assets/image.png). Absolute URLs are left untouched. If no matching file is found, the image or link is omitted to prevent broken links.

Nested Content and Collections

This plugin flattens your GitHub file structure into a single list within the chosen Framer collection. Each Markdown file's path is reflected in its slug. For example, a file at docs/guides/getting-started.md will have a slug like docs/guides/getting-started. To create a true nested structure in Framer, you'll need to create multiple collections, each syncing with a different base path. For instance, one collection could sync with docs/guides and another with docs/tutorials.

Public and Private Repositories

The plugin supports both public and private GitHub repositories. Connect securely to private repositories using a personal access token.

Pricing

You can try the plugin with 10 syncs available for free. To sync more times you will need to buy a monthly add-on of $49.