Developer Guide

Notion Setup

Check out the Quick Start Guide to setup your Notion workspace.

Local development

git clone https://github.com/m4rrc0/poko-notion.git
cd poko-notion
npm install

Rename or copy .env.dist file in .env and paste your API key as the NOTION_TOKEN and optionnaly the ID of the Notion page that is the root of your web project as NOTION_ROOT_ID.

Then the magic should operate with

npm run dev

Other commands

All commands are run from the root of the project, from a terminal:

CommandAction
npm installInstalls dependencies
npm run devStarts local dev server at localhost:3000
npm run buildBuild your production site to ./dist/
npm run previewPreview your build locally, before deploying
npm run cleanRemove downloaded assets and poko generated files
npm run fetch:onceOnly fetch content without building the site
npm run fetch:watch [- delay]Fetch content at regular interval (in ms) (default - 120000)
npm run dev:watch [--delay=10000]npm run dev + npm run fetch:watch concurrently (with optional delay change)

Ask questions

While we work on the docs, come and ask questions in the Github discussions.