Getting started
Migrating from Nextra#
Migrating can be a long journey, this guide aims to create a clear set of steps to move to Guider.
Compatability table#
| Feature | Nextra | Guider |
|---|---|---|
| MDX based pages | ✓ | ✓ |
| I18N support | ✓ | 𐄂 |
| Search bar | ✓ | 𐄂 |
| Dark mode | ✓ | ✓ |
| Light mode | ✓ | 𐄂 |
| Banners | ✓ | 𐄂 |
| SEO & custom meta tags | ✓ | ✓ |
| Customizable layouts | ✓ | ✓ |
| Custom navigation links | ✓ | ✓ |
| Component: Callout | ✓ | ✓ |
| Component: Tabs | ✓ | ✓ |
| Component: Cards | ✓ | 𐄂 |
| Component: Steps | ✓ | ✓ |
| Component: FileTree | ✓ | 𐄂 |
| Component: Bleed | ✓ | 𐄂 |
| Npm2Yarn integration | ✓ | ✓ |
| Edit on GitHub link | ✓ | ✓ |
| Collapsable sidebar | ✓ | 𐄂 |
Migration steps#
- Make a guider project: Make a new guider project by following this guide.
- Copy your MDX files over: Copy over all MDX files into the pages directory of the new project.
- Remove or replace unsupported components: Not all components are supported by Guider. Check the compatibility table above.
- Migrate
_meta.jsonfiles: In Nextra, meta files are for storing navigation structures. In Guider this is done in the theme config. Check out this guide. - Migrate the theme config: Many Nextra theme configuration options are also possible in Guider. Check out the compatibility table above.
- Finished: That should be everything to migrate to Guider, congratulations!