An open-source, production-grade Notion reverse proxy engineered to eliminate the $12/month custom domain limitation while delivering enterprise-level customization capabilities. Built as a zero-dependency TypeScript package specifically architected for Cloudflare Workers edge computing and modern Node.js runtimes, enabling organizations to transform Notion workspaces into fully-branded, SEO-optimized websites with complete control over styling, metadata, and functionality. The solution addresses a critical market gap by providing sophisticated URL rewriting, client-side navigation preservation, and multi-tenant configuration management—features typically found in premium CMS platforms—while maintaining complete ownership and deployment flexibility. Successfully deployed on Cloudflare's global edge network, processing requests with sub-50ms latency through intelligent caching strategies and modular architecture. Published as an NPM package with comprehensive CLI tooling for scaffolding, template generation, and automated minification workflows, demonstrating production-ready software distribution and developer experience optimization. All work and interactive previews are documented in Notion.

Media

Project Points Earned

  1. Architected and published a zero-dependency TypeScript reverse proxy package on NPM with 100% type safety, eliminating external vulnerabilities and reducing bundle size for optimal cold start performance on edge computing platforms
  2. Engineered advanced HTML/CSS/JavaScript minification system achieving 20-40% file size reduction while preserving functionality through intelligent regex pattern extraction, string literal protection, and AST-aware whitespace removal
  3. Built multi-tenant configuration management system with singleton pattern and configKey-based instance caching, enabling isolated proxy configurations for multiple domains in single runtime with independent state management
  4. Implemented sophisticated URL rewriting engine using regex-based slug-to-pageId mapping with 301 redirects, enabling SEO-friendly clean URLs while maintaining seamless bidirectional navigation between custom domains and Notion infrastructure
  5. Developed client-side navigation proxy system intercepting History API (pushState/replaceState) and XMLHttpRequest/Fetch calls, rewriting URLs in real-time to maintain user experience within custom domain without page reloads
  6. Created comprehensive SEO metadata customization system supporting page-specific Open Graph, Twitter Cards, and JSON-LD structured data injection for enhanced search engine visibility and social media sharing optimization
  7. Engineered Content Security Policy (CSP) header manipulation to dynamically inject Google Analytics, Tag Manager, and custom font domains while forcing frame-ancestors to wildcard for embedding flexibility
  8. Built TypeScript CLI toolchain with init/generate commands supporting custom path resolution and optional minification flags, automating configuration scaffolding and build-time string constant generation
  9. Implemented edge-compatible request/response header rewriting for cookie domain transformation, replacing notion.site domains with custom hostnames while preserving session state across proxy boundaries
  10. Designed automatic localhost detection mechanism normalizing domain configuration for local development, enabling seamless testing workflows without environment-specific configuration changes
  11. Architected CI/CD pipeline with GitHub Actions implementing automated semantic versioning, conventional commits validation, parallel lint/type-check/build jobs with pnpm caching for sub-minute deployment cycles