Nooxy

---

The Problem

You built something great in Notion. Now you want to share it with the world on your own domain.

Your options today:

| Solution | Cost | SEO | Customization | Interactivity |
|----------|------|-----|---------------|---------------|
| Notion Sites | $10-22/mo | Limited, noindex issues | Minimal | Full |
| Super.so | $12-28/mo | Good, but subdomain-only hurts rankings | Good | Lost (static) |
| Fruition | Free | Poor, outdated | Limited | Full |
| Nooxy | Free | Full SEO suite | Complete | Full |

Notion Sites charges $10/month per domain with limited SEO and customization. Super.so costs $12-28/month and converts your pages to static HTML—you lose Notion's live databases, filtering, and real-time updates. Fruition is no longer maintained and lacks modern SEO features.

Nooxy gives you everything. For free.

$3

These sites run on Nooxy right now:

- os.draphy.org — Life documented as a file system
- draphy.org — Personal site

View source, check the SEO tags, test the interactivity. It works.

---

Why Nooxy?

$3 - $0/month — No subscriptions, no limits - Full SEO — Canonical URLs, structured data, proper indexing - Complete control — Inject any CSS, JavaScript, HTML - Live Notion — Real-time databases, filtering, collaboration - Your domain — Professional URLs like yourdomain.com/about

$3 - ~~$120-336/year~~ on hosting fees - ~~Subdomain SEO penalties~~ from free tiers - ~~Static pages~~ that lose Notion's power - ~~Vendor lock-in~~ from closed platforms - ~~Outdated tools~~ that break with Notion updates

---

Features

$3

Nooxy rewrites Notion's HTML to give search engines exactly what they need:

- Removes noindex tags — Your pages get indexed by Google
- Canonical URLs — https://yourdomain.com/about not /About-abc123def
- Structured data — JSON-LD schema for rich search results
- Open Graph & Twitter Cards — Beautiful social media previews
- Custom meta tags — Title, description, keywords, author per page
- AI attribution — Proper source credits for ChatGPT, Claude, Perplexity
- XML sitemap — Auto-generated at /sitemap.xml
- Robots.txt — Proper crawler directives at /robots.txt

$3

- Custom CSS — Override any Notion style, add your brand
- JavaScript injection — Analytics, interactions, custom functionality
- HTML headers — Navigation bars, announcements, CTAs
- Google Fonts — Apply any font family site-wide
- Google Analytics — Built-in GA4 support

$3

- Zero dependencies — Nothing to break, nothing to update
- Edge computing — Runs on Cloudflare Workers' global network
- Node.js support — Works with any modern Node.js runtime (18.17+)
- Multi-tenant — Host multiple sites from one deployment
- Local development — Test locally before deploying

$3

- TypeScript — Full type safety and IntelliSense
- CLI tools — npx nooxy init and npx nooxy generate
- Auto-minification — CSS, JS, HTML optimized automatically
- Clean URLs — /about instead of /About-Page-abc123def456

---

Quick Start

$3

``bash
npm install nooxy
`

$3

`bash
npx nooxy init
`

This creates a nooxy/ folder with all configuration files.

$3

Edit nooxy/config.js:

`javascript
export const SITE_CONFIG = {
// Your custom domain
domain: 'yourdomain.com',

// Your Notion workspace (e.g., yourname.notion.site)
notionDomain: 'yourname.notion.site',

// Site name for SEO
siteName: 'Your Site Name',

// Map URLs to Notion page IDs
slugToPage: {
'/': 'YOUR_HOME_PAGE_ID', // yourdomain.com/
'/about': 'YOUR_ABOUT_PAGE_ID', // yourdomain.com/about
'/blog': 'YOUR_BLOG_PAGE_ID', // yourdomain.com/blog
},

// SEO configuration (optional but recommended)
seo: {
indexing: true, // Enable search engine indexing
keywords: 'your, keywords, here',
defaultAuthor: 'Your Name',
},

// Required: Generated files (don't modify)
customHeadCSS: HEAD_CSS_STRING,
customHeadJS: HEAD_JS_STRING,
customBodyJS: BODY_JS_STRING,
customHeader: HEADER_HTML_STRING,
};
`

$3

`bash
npx nooxy generate
`

$3

Cloudflare Workers (recommended):

`typescript
import { initializeNooxy } from 'nooxy';
import { SITE_CONFIG } from './nooxy/config';

const proxy = initializeNooxy(SITE_CONFIG);

export default {
async fetch(request: Request): Promise {
return proxy(request);
},
};
`

Node.js:

`typescript
import { initializeNooxy } from 'nooxy';
import { SITE_CONFIG } from './nooxy/config';
import http from 'node:http';

const proxy = initializeNooxy(SITE_CONFIG);

http.createServer(async (req, res) => {
const request = new Request(http://${req.headers.host}${req.url});
const response = await proxy(request);
res.statusCode = response.status;
response.headers.forEach((v, k) => res.setHeader(k, v));
res.end(Buffer.from(await response.arrayBuffer()));
}).listen(8787);
`

---

Configuration Reference

$3

| Field | Description |
|-------|-------------|
| domain | Your custom domain (e.g., example.com) |
| notionDomain | Your Notion workspace domain (e.g., yourname.notion.site) |
| siteName | Site name for SEO and social sharing |
| slugToPage | URL path to Notion page ID mapping |
| customHeadCSS | Generated CSS string |
| customHeadJS | Generated head JavaScript string |
| customBodyJS | Generated body JavaScript string |
| customHeader | Generated header HTML string |

$3

`javascript
seo: {
// Enable search engine indexing (default: true)
indexing: true,

// Canonical domain (if different from domain)
// Useful when nooxy runs on subdomain but SEO points to main domain
canonicalDomain: 'example.com',

// Path mapping for canonical URLs
// Maps nooxy paths to canonical domain paths
canonicalPathMap: {
'/': '/home', // os.example.com/ → example.com/home
'/docs': '/documentation',
},

// Meta keywords for SEO
keywords: 'notion, website, custom domain',

// Default author for pages
defaultAuthor: 'Your Name',

// Replace "Notion" branding with custom text
brandReplacement: 'Your Brand',

// AI crawler attribution (ChatGPT, Claude, etc.)
aiAttribution: 'Your Name - yourdomain.com',
}
`

$3

`javascript
pageMetadata: {
'NOTION_PAGE_ID': {
title: 'Custom Page Title',
description: 'Custom meta description for this page',
image: 'https://yourdomain.com/og-image.jpg',
author: 'Page Author Name',
},
}
`

$3

`javascript
nooxy: {
// Show "Made with Nooxy" badge in header
// Default: true
// Set to false to hide it... 💔 it'll break my heart, but hey,
// if it helps your site look cleaner, I'll survive... probably 😢
showBadge: true,
}
`

$3

| Field | Description |
|-------|-------------|
| twitterHandle | Twitter/X handle for social cards (e.g., @yourusername) |
| siteIcon | Custom favicon URL |
| googleFont | Google Font family name (e.g., Inter) |
| googleTagID | Google Analytics measurement ID |
| fof | Custom 404 page configuration |
| subDomains | Subdomain redirect rules |

---

CLI Commands

$3

`bash
npx nooxy init
`

Creates the nooxy/ directory with all configuration templates.

$3

`bash


Standard generation (with minification)

npx nooxy generate

Custom path

npx nooxy generate --path=./my-project

Without minification (for debugging)

npx nooxy generate --no-minify
`

Converts your custom files to optimized, importable strings.

---

Customization

$3

`css
/ Hide Notion's default elements /
.notion-topbar { display: none !important; }

/ Custom styling /
.notion-page-content {
max-width: 900px;
margin: 0 auto;
font-family: 'Inter', sans-serif;
}

/ Dark mode support /
.dark .notion-page-content {
background: #1a1a1a;
}
`

$3

`javascript
// Analytics, interactions, custom functionality
document.addEventListener('DOMContentLoaded', () => {
console.log('Site loaded with Nooxy!');

// Track page views, add smooth scrolling, etc.
});
`

$3

`html



`

---

How It Works

`
User Request → Nooxy → Notion
↓
Rewrite URLs, inject SEO, add customizations
↓
User Response ← Modified HTML
`

1. Intercepts requests to your custom domain
2. Maps clean URLs (/about) to Notion page IDs
3. Fetches content from Notion's servers
4. Rewrites meta tags, URLs, and structured data for SEO
5. Injects your custom CSS, JavaScript, and headers
6. Serves the optimized response to visitors

---

Compared to Alternatives

$3

| | Notion Sites | Nooxy |
|---|---|---|
| Price | $10-22/mo | Free |
| Custom domain | Paid add-on | Included |
| SEO control | Limited | Full |
| CSS/JS injection | No | Yes |
| noindex removal | Manual | Automatic |

$3

| | Super.so | Nooxy |
|---|---|---|
| Price | $12-28/mo | Free |
| Notion interactivity | Lost (static) | Preserved |
| Database filtering | No | Yes |
| Real-time updates | No | Yes |
| Hosting type | Subdomain | Your domain |

$3

| | Fruition | Nooxy |
|---|---|---|
| Maintained | No (2020) | Yes (2024+) |
| SEO features | Basic | Comprehensive |
| TypeScript | No | Yes |
| CLI tools | No | Yes |
| Multi-tenant | No | Yes |

---

Architecture

`
src/
├── index.ts # Main export
├── proxy.ts # Core reverse proxy
├── types.ts # TypeScript definitions
├── helpers/ # Utilities
├── handlers/ # Request handlers (sitemap, robots, etc.)
├── rewriters/ # HTML rewriting (meta, data, headers)
└── cli/ # CLI commands (init, generate)
`

---

Troubleshooting

$3

- Verify Notion page IDs are correct (32-character hex)
- Ensure pages are published publicly in Notion
- Check notionDomain matches your Notion workspace

$3

- Run npx nooxy generate after changes
- Use !important to override Notion styles
- Check browser console for errors

$3

- Ensure seo.indexing is true (default)
- Check that you're viewing the source (not rendered DOM)
- Verify your deployment is using the latest build

---

Support

- GitHub Issues: Report bugs or request features
- Discussions: Ask questions
- Email: contact@draphy.org

---

Contributing

See CONTRIBUTING.md for guidelines.

---

License

MIT License - see LICENSE for details.

---

Acknowledgments

Inspired by Fruition and NoteHost, rebuilt for the modern web with comprehensive SEO, TypeScript, and zero dependencies.

---