notion-prod-checklist

# Notion API Production Deployment Checklist ## Overview Structured 12-section checklist for deploying Notion API integrations to production. Covers authentication security, capability scoping, page sharing, rate limit compliance, pagination correctness, error handling, API versioning, retry logic, monitoring, graceful degradation, data validation, and OAuth token lifecycle. Each section maps to a specific failure mode observed in production Notion integrations. This skill produces a verified pass/fail report. Every item is actionable and testable — no aspirational guidance. Full code examples for each section are in [references/code-examples.md](references/code-examples.md). ## Prerequisites - **Node.js 18+** with `@notionhq/client` v2.x installed - Working Notion integration tested in a development workspace - Production Notion API token (internal) or OAuth credentials (public integration) - Target databases and pages identified by ID - Deployment platform configured (Vercel, Railway, AWS, etc.) Verify SDK is installed: ```bash node -e "const { Client } = require('@notionhq/client'); console.log('SDK loaded')" 2>/dev/null \ || echo "MISSING: npm install @notionhq/client" ``` ## Instructions Work through each section sequentially. Mark items pass or fail. A single fail in sections 1-6 is a deployment blocker. --- ### Section 1: Token Stored in Environment Variables (Never Hardcoded) Production tokens must never appear in source code, config files committed to g...