notion-feeder
notion-feeder copied to clipboard
🕸 A Node app for creating a Feed Reader in Notion.
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
-
Create a new Notion Integration and copy the secret code which you'll use as
NOTION_API_TOKEN
in Step 4. -
Duplicate this template to your Notion workspace.
-
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.
-
Fork this GitHub repository and once forking is complete, go to your forked GitHub repository.
-
Enable the GitHub Actions by visiting the Actions tab and click "I understand my workflows, enable them".
-
Click on the Get Feed action in the left panel and then click "Enable workflow".
-
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. -
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
Contributors
Extra
- You can request features and file bugs here.
- In case you get stuck somewhere, feel free to contact me at my email.