Notion Feeder

A Node.js app for creating a Feed Reader in Notion.

---

If you loved this product and value my time, consider sending some love to me. This will enable me to work on more projects like these in the future.

---

Features

Separate database for your feed sources and feed items.

Add, enable and disable your feed sources.

Feeds are sourced daily and stored in the Reader database. New feed items are marked with 🔥.

Read a feed directly in Notion Page View.

Different views of accessing Unread, Starred feed items.

Setup

1. Create a new Notion Integration and copy the secret code which you'll use as NOTION_API_TOKEN in Step 4.

2. Duplicate this template to your Notion workspace.

3. Once the template is available on your Notion Workspace, open the Reader database. Click Share > Invite and search the Notion integration you created in Step 1 and Click Invite. Do the same for the Feeds database.

4. Fork this GitHub repository and once forking is complete, go to your forked GitHub repository.

5. Enable the GitHub Actions by visiting the Actions tab and click "I understand my workflows, enable them".

6. Click on the Get Feed action in the left panel and then click "Enable workflow".

7. Go to Settings > Secrets. Add the following three secrets along with their values as Repository secrets.

   NOTION_API_TOKEN
   NOTION_READER_DATABASE_ID
   NOTION_FEEDS_DATABASE_ID
   

   To find your database id, visit your database on Notion. You'll get a URL like this: https://www.notion.so/{workspace_name}/{database_id}?v={view_id}. For example, if your URL looks like this: https://www.notion.so/abc/xyz?v=123, then xyz is your database ID.

8. Delete the release workflow file as it is only required in the original repository.

That's it. Now every day, your feed will be updated at 12:30 UTC. You can change the time at which the script runs from here.

Development

You are more than welcome to contribute to this project.

Prerequisites

These things are required before setting up the project.

• Git
• Ubuntu 18.04 or 20.04
• Node.js Read Guide

Setup

Follow these instructions to get the project up and running.

# clone the repo
$ git clone https://github.com/ravgeetdhillon/notion-feeder.git

# change directory
$ cd notion-feeder

# install dependencies
$ npm install

# enable webpack bundling
$ npm run watch

Tech Stack

• Node
• Notion API

Contributors

• Ravgeet Dhillon

Extra

• You can request features and file bugs here.
• In case you get stuck somewhere, feel free to contact me at my email.