react-notion-x VS react-notion

Formatting the API response (eg. from https://developers.notion.com/reference/retrieve-a-block) is tough, so I want to use a community-maintained package like https://github.com/NotionX/react-notion-x. Most Notion API users use Notion as a website builder so almost all the packages are in React.js or Next.js

I love coming across a great blog like this an realizing it was built using two of my open source repos:

- https://github.com/transitive-bullshit/nextjs-notion-starter...

- https://github.com/NotionX/react-notion-x

Using this library, you can easily get data from Notion Pages.

I used an open source Notion library that I'm a main maintainer of called React-Notion-x. It takes Notion data and turns it into html blocks that you can add to your website.

Long: Looks like he is using Notion as a CMS (using something like https://github.com/NotionX/react-notion-x) for his site and not the actual Notion share feature, seen by that the page names are not included in the urls (and that he is using NextJS for his site).

For reference, we're using the notion-compat tool from the react-notion-x package.

There are already existing libraries that wrap it, you can search them on Github, for example this one https://github.com/NotionX/react-notion-x

In my previous article in this series, I had created my own react components to work with the Notion API due to the lack of a recognized renderer that works with Official Notion API. I came across the react-notion-X library but that did not use the Official Notion API then so I chose to create my own renderer. But soon after I published that article, Travis Fischer (creator of react-notion-x and a couple of really handy tools) added support for the official Notion API with notion-compat (still a WIP) which allows you to use react-notion-x’s powerful react renderer with the official API. So I replaced my renderer components with the react-notion-x renderer which gave me a huge performance boost.

Yes, it's using Notion as a CMS + react-notion-x (1) + some custom styling.

(1) https://github.com/NotionX/react-notion-x

To connect my web to my Notion workspace I used React Notion from Splitbee. You can check it for a while.

It would make sense to not have server-side rendering if you're building both browser and desktop apps, since that would mean avoiding a separate framework only for the browser.

Another clue is that people who try to use Notion as a CMS for their blogs had to build out a React library to emulate the feel of Notion itself: https://github.com/splitbee/react-notion https://github.com/NotionX/react-notion-x.

* Can break at any time because we use Notion's Private API. (ing forward for the Public API)

We initially built our blog [2] & documentation [3] with react-notion but switched away with the Documentation to Sanity. We simply needed the versioning and publishing features.

Nevertheless, react-notion can be a great way for websites to display rich text content. The implementation is easy and it looks sleek out of the box.

[1] https://github.com/splitbee/react-notion