To get started using Microgen, fork the repo. To deploy your site on the internet, you must connect your repo to the free Tina CMS service and your choice of static webhost.
If you plan to add custom blocks to your site, you may want to consider cloning the repo instead. See the Development doc for more details.
- Login to Tina Cloud or create a new account.
- Go to projects and create a new custom project.
- Follow the steps to select your repo (make sure to add http://localhost:3000 as the site URL).
- Save the Client ID and Token of your newly created project for later use.
Microgen can be deployed to the static host of your choice. If you want your site to live on Web3, we recommend using Fleek.
- Login to Fleek or create a new account.
- Choose Add New Site to create a new site and follow the steps to select your forked repo (select "IPFS" as "Hosting Service").
- Go to Hosting > Settings > Advanced Build Settings and add the 2 environment variables from Tina as shown in the Environment Variables section below.
- Go to Configuration on Tina Cloud and add the site URL created from Fleek (https://<replace-with-your_site-name>.on.fleek.co).
- Deploy your site by selecting Deploy Site.
NEXT_PUBLIC_TINA_CLIENT_ID=[YOUR CLIENT ID FROM TINA]
TINA_TOKEN=[YOUR READ ONLY TOKEN FROM TINA]
NEXT_PUBLIC_TINA_BRANCH=main
Once your site has successfully deployed, you can make edits by adding /admin
to the URL of your site. For example, https://www.yoursite.com/admin
. Only sites added to the Site URLs section in Tina are allowed to make edits from the admin URL.
If images are not showing up on your site, you may need to enable and sync media from Tina. Choose media from the sidebar on the Tina site and click "Enable Media", then click the "Sync Media" button.