🎯 Getting Started
To start using the Turbo Repo with Node.js and Yarn, follow these steps:
Install project dependencies
yarn install
Create new Storyblok space
Depending on the selection in the Server Location
field, you will need to create the appropriate variable in the .env
file in the 4 step.
Create new Personal Access Token (PAT) in your Storyblok's account settings
Copy the token
and save it. We will need it in the next step.
Fill in the required environment variables.
STORYBLOK_PERSONAL_ACCESS_TOKEN
- The token was generated in step 3.
STORYBLOK_REGION
- The value en
or us
, depending on the region you chose when creating the space in step 2.
STORYBLOK_SPACE_ID
- ou can find this value in the settings
tab in Storyblok.
STORYBLOK_SPACE_ID
should not contain #
!
Example:
STORYBLOK_PERSONAL_ACCESS_TOKEN="r7zigOmTasdymmQq7QtQziasq-122378-iaoKPHf-6tWJ9e8WWas1"
STORYBLOK_REGION="eu"
STORYBLOK_SPACE_ID="123456"
Delete unnecessary items in your space
When creating a new space in Storyblok, it adds several default components and a Home page story. We don't want this. The script you will run in the next step will create these items anew.
Remove story
Remove components
Run the storyblok-setup
script
yarn storyblok:setup
The script will create several items for you in Storyblok CMS:
- Datasources,
- Few components in block library,
- The basic page structure in the content tab, which includes
homepage
,global header
,global footer
,configuration story
,not found page
,redirects
The script will also create a .env
file in the apps/web/.env
directory based on your data. Finally, the command yarn dev
will be automatically executed.
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_STORYBLOK_API_URL=https://gapi.storyblok.com/v1/api
NEXT_PUBLIC_STORYBLOK_PREVIEW_TOKEN=*************
NEXT_PUBLIC_STORYBLOK_MAIN_APP_FOLDER=natu-root
NEXT_PUBLIC_STORYBLOK_EXCLUDED_FOLDERS_FROM_ROUTING=configuration-a93cfcb3