Monitor your Node.js modules and repositories from a Notion page!

This project is a GitHub Action that exports a set of data gathered from GitHub and NPM to publish it your Notion.

The collected data are:

• GitHub repository name
• NPM downloads per month
• GitHub stars
• Number of open issues, optionally filtered by labels
• Number of open pull requests
• Latesr version published on NPM
• Checkbox to mark archived repositories
• Direct link to the repository
• Direct link to the NPM page
• NPM package size in bytes
• Last commit date
• Last edited date

Note
The project is still in early development and the data exported are not yet customizable nor configurable.
I aim to make this application available from the Notion Connections marketplace.

This GitHub Action will:

• Fetch the list of repositories from GitHub using the provided github-repository-query input. You can test the query on GitHub Search
• For each repository will check if it's a Node.js module and if it's published on NPM collecting additional data
• Read the Notion database and update the existing rows or create new ones. Unrecognized rows will be deleted.

If the row's data is not changed, the row will not be updated.

To install this GitHub Action, you need to create a new GitHub repository and add a .github/workflows/notion-board.yml file with the following content:

name: Notion Board

on:
  workflow_dispatch: # Allow manual trigger
  schedule:
    - cron: "0 12 * * *" # "Everyday at 12:00 UTC (5:00 PT)" https://crontab.guru/#0_12_*_*_*

jobs:
  update-notion-board:
    runs-on: ubuntu-latest

    steps:
      - name: Update Notion
        uses: Eomm/notion-board@v0
        with:
          github-repository-query: user:Eomm is:public
          notion-token: ${{ secrets.NOTION_TOKEN }}
          notion-database-id: ${{ secrets.NOTION_DATABASE_ID }}

In order to use this GitHub Action, you need to create:

1. A notion integration token to allow the GitHub Action to update the database
2. A notion database to store the data

To get the token, you must follow the official Notion documentation to create the required resources.
Note that you must add the following Capabilities to the integration:

• Read content
• Update content
• Insert content

You can stop at the "Step 4: Add an item to the database" section.

Finally, when you are about to create the new database, you need to use the following database template.

Warning
The database template can't be modified otherwise the GitHub Action will not work. The columns' name and type are important.

Copyright Manuel Spigolon, Licensed under MIT.