Import Button
The import button lets users create their own copy of your project and import it into Forestry in one fell swoop.
If you have a static site project — like a theme or starter site — that is optimized for use with Forestry and you want to share it, adding an import button to your README or website will make it easy for users to get started using your project with Forestry.
The Add Site URL
Your import button will use our quick start flow to clone the project into the user’s account and import it into Forestry. The most basic add site URL will look like this: https://app.forestry.io/quick-start?repo=user/project
. In this case, the repo
parameter is the path to the repo on Github. Quick start accepts the following URL parameters:
Parameter | Description | Type | Default |
---|---|---|---|
repo |
Path to repository, of the format $group/$project |
String | None |
provider |
Which git provider your repository is hosted from | github , gitlab , or bitbucket |
github |
engine |
The static site generator used by your project. | hugo , jekyll , vuepress or other |
None |
version |
The Hugo version to use (only applies when engine is hugo ) |
Decimal | Latest |
branch |
The repository branch to import | String | master |
config |
Relative path to your source files | String | / |
Project Requirements
Your project should be a fully functional static site project that can be imported into Forestry, and should be available from a public repository on Github, GitLab, or BitBucket.
For example, if you want to create an import button for your Hugo theme, you should create a new Hugo site configured to use your theme. Forestry won’t be able to import your theme code on its own, as it doesn’t share the same file structure as a Hugo site.
Buttons
We have provided three SVG buttons for your use:
Brand Color
https://assets.forestry.io/import-to-forestry.svg
Light
https://assets.forestry.io/import-to-forestryW.svg
Dark
https://assets.forestry.io/import-to-forestryK.svg
Button Generator
You can use our button generator below to create the appropriate markup for your button.
Caught a mistake or want to contribute to the docs? Edit this page on Github!