docs: add multi-source docs page#5269
Merged
kennyderek merged 8 commits intomainfrom May 4, 2026
Merged
Conversation
Co-Authored-By: kenny <kenny@buildwithfern.com>
Contributor
Author
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
Contributor
|
🌿 Preview your docs: https://fern-preview-devin-1777565083-add-multi-source-docs.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Co-Authored-By: kenny <kenny@buildwithfern.com>
Co-Authored-By: kenny <kenny@buildwithfern.com>
Co-Authored-By: kenny <kenny@buildwithfern.com>
This was referenced Apr 30, 2026
….com site Co-Authored-By: kenny <kenny@buildwithfern.com>
Contributor
Author
|
Devin is archived and cannot be woken up. Please unarchive Devin if you want to continue using it. |
Contributor
|
🌿 Preview your docs: https://fern-preview-a3a67d20-9d4e-4081-9fd0-760b345f3414.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Contributor
devalog
approved these changes
May 4, 2026
Contributor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new documentation page for the multi-source docs feature, which lets multiple teams publish to the same custom domain from independent repositories.
Changes
fern/products/docs/pages/preview-publish/multi-source.mdx— covers:multi-source: trueon instances enables basepath-aware publishingfern docs theme export/upload/list) keep branding consistent across reposdocs.ymlinstances.multi-sourceParamField to the instances configuration reference2026-04-30.mdxentry for the featureWorked example
The "Example" section now mirrors the live example at multi-source.docs.buildwithfern.com, with source at fern-api/docs-examples/multi-source. It walks through six independent
fern/projects on one shared domain — a homepage at the bare root, a/seedsteam hub with two nested sub-children (/seeds/sunflower,/seeds/tomato), and standalone/greenhousesand/nurseryteams. This also demonstrates the nested-sub-paths pattern (one multi-source project published under another), which wasn't previously covered.Review & Testing Checklist for Human
multi-source: true,global-theme)Notes
instances.multi-sourceproperty replaces the deprecatedexperimental.basepath-awareflag (added in CLI 5.2.0).multi-source.docs.buildwithfern.comURLs (matching the live example site) and intentionally omitscustom-domainsince the live example uses Fern's preview domain — there's a one-line note explaining how to add one for production deployments.Link to Devin session: https://app.devin.ai/sessions/2302d06a2d04471f95b133e0c0d7b5c0