A static site system built with Next.js and the Notion API, NotionNext enables creators and teams to easily publish content managed within Notion. It eliminates server requirements and simplifies website setup for blogs, portfolios, knowledge bases, and product pages, allowing users to continue their familiar Notion workflow while generating accessible, searchable websites.

How It Works

NotionNext transforms Notion content into static websites using Next.js and the Notion API. Users manage articles, categories, tags, menus, and pages directly within Notion. The system then publishes this content as a standalone, accessible, and searchable website. This approach offers a short deployment path, typically involving forking the repository, connecting to a Notion template, and deploying via platforms like Vercel, maintaining a familiar writing workflow while generating professional static sites with clear data lineage for future migrations.

Quick Start & Requirements

Local development requires Node 20 and Yarn 1. Deployment via Vercel is recommended, with an estimated setup time of 20 minutes. Key resources include:

• Online Preview: preview.tangly1024.com
• Getting Started Guide: https://docs.tangly1024.com/getting-started
• Theme Overview: https://docs.tangly1024.com/themes
• Documentation Site: notionnext.tangly1024.com

Highlighted Details

• Features 25 built-in themes catering to diverse use cases, including personal blogs, documentation, portfolios, landing pages, photography showcases, and navigation sites.
• Supports essential features for long-term operation: custom domains, SEO optimization, sitemap generation, RSS feeds, comment systems (e.g., Twikoo, Giscus), site search, advertising integration, and email subscriptions.
• The system is open-source and controllable, with source code, configurations, and themes available in the user's repository for custom development.
• Provides a clear data flow, with Notion handling content management and the site focusing on presentation and distribution, allowing for potential future migration to other systems like Markdown.

Maintenance & Community

The project is maintained by the notionnext-org GitHub organization. Community engagement is encouraged through GitHub Discussions, with clear guidelines for participation, contribution (issues, documentation, themes, code), and project governance.

Licensing & Compatibility

NotionNext is released under the MIT License. However, the project includes a usage statement specifying use for "personal learning and legal site construction only," prohibiting the publication of illegal content. This clause should be reviewed for specific commercial or closed-source integration needs.

Limitations & Caveats

The provided README does not explicitly detail limitations, alpha status, or known bugs. The project's functionality is dependent on the Notion API, which may be subject to changes by Notion.