notion-local-dev-loop

# Notion Local Dev Loop ## Overview Set up a fast, reproducible local development workflow for Notion integrations. This skill covers creating a dedicated dev integration with its own token, structuring the project for testability, mocking the Notion SDK in unit tests, and running integration tests against a sandboxed dev workspace. The approach keeps production data safe while enabling rapid iteration. ## Prerequisites - Completed `notion-install-auth` setup (you have a working Notion integration) - Node.js 18+ with npm/pnpm, or Python 3.10+ - A Notion workspace where you can create test pages and databases ## Instructions ### Step 1: Create a Dev Integration and Workspace Sandbox Create a separate integration exclusively for development. This prevents accidental writes to production data. 1. Go to **Settings & Members > Connections > Develop or manage integrations** (or visit [developers.notion.com](https://developers.notion.com)) 2. Click **New integration** and name it `My App — Dev` 3. Copy the token (starts with `ntn_`) into `.env.development` 4. Create a dedicated **Dev Workspace** page (or a top-level "Dev Testing" page) and share it with the dev integration 5. Inside that page, create test databases that mirror your production schema ```bash # .env.development — git-ignored, dev only NOTION_TOKEN=ntn_dev_xxxxxxxxxxxxxxxxxxxx NOTION_TEST_DATABASE_ID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee NOTION_TEST_PAGE_ID=ffffffff-0000-1111-2222-333333333333 # .env.example —...