https://github.com/ravgeetdhillon/notion-feeder
🕸 A Node app for creating a Feed Reader in Notion.
https://github.com/ravgeetdhillon/notion-feeder
atom-reader feed feed-reader javascript node notion notion-api rss-reader
Last synced: 14 days ago
JSON representation
🕸 A Node app for creating a Feed Reader in Notion.
- Host: GitHub
- URL: https://github.com/ravgeetdhillon/notion-feeder
- Owner: ravgeetdhillon
- License: mit
- Created: 2021-10-16T06:07:14.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-23T03:54:35.000Z (11 months ago)
- Last Synced: 2025-04-04T01:07:45.523Z (22 days ago)
- Topics: atom-reader, feed, feed-reader, javascript, node, notion, notion-api, rss-reader
- Language: JavaScript
- Homepage: https://www.producthunt.com/posts/notion-feeder
- Size: 6.77 MB
- Stars: 310
- Watchers: 4
- Forks: 603
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome - ravgeetdhillon/notion-feeder - reader,feed,feed-reader,javascript,node,notion,notion-api,rss-reader pushed_at:2024-05 star:0.3k fork:0.6k 🕸 A Node app for creating a Feed Reader in Notion. (JavaScript)
README
[](https://github.com/ravgeetdhillon/notion-feeder/actions/workflows/release.yml)
[](https://github.com/ravgeetdhillon/notion-feeder/actions/workflows/main.yml)
[](https://opensource.org/licenses/MIT)
---
If you love this product and value my time, consider [sending some love](https://paypal.me/ravgeetdhillon) to me. This will enable me to work on more projects like these in the future.
[](https://paypal.me/ravgeetdhillon)
---
# Notion Feeder
A Node.js app for creating a Feed Reader in [Notion](https://notion.so).
## 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](https://www.notion.so/my-integrations) and copy the secret code which you'll use as `NOTION_API_TOKEN` in Step 4.
2. Duplicate this [template](https://ravsamhq.notion.site/Feeder-fa2aa54827fa42c2af1eb25c7a45a408) to your Notion workspace.
3. Once the template is available on your Notion Workspace, open the **Reader** database. Click the three-button page menu in the top right corner **...** _> Add connections_ 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](.github/workflows/release.yml) as it is only required in the original repository.
9. That's it. Now every day, your feed will be updated at 12:30 UTC.
**Note**: You can change the time at which the script runs from [here](.github/workflows/main.yml#L5) and the frequency of running from [here](.github/workflows/main.yml#L15).
## 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](https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-20-04)
### Setup
Follow these instructions to get the project up and running.
```bash
# 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](https://nodejs.org/)
- [Notion API](https://developers.notion.com)
## Contributors
- [Ravgeet Dhillon](https://github.com/ravgeetdhillon)
## Extra
- You can request features and file bugs [here](https://github.com/ravgeetdhillon/notion-feeder/issues).
- In case you get stuck somewhere, feel free to contact me at my [email](mailto:[email protected]).