clothion

Embed widgets in your Notion pages easily

Description • Usage • FAQ • Self-host • Contribute
Documentation

⚠️ This is a very rough first version, existing widgets are very limited, but the API works
Consider contributing !

Description

Clothion is a free, open-source tool that allows you to build charts and other widgets directly from your Notion database.

You can then embed the widgets into your Notion pages.

---

Clothion also offers a small API to easily query your data, and build your own widget.

Make sure to check the Documentation !

---

Features :

• Free to use
• No limitation on the number of graphs
• No pesky logo on your charts
• Open-source
• Build your own widget from the API
• Cached results for faster loading time
• Self-host for maximum privacy

Usage

First, create your own Notion integration, and a Notion table that you will use as data source.

Then, go to clothion.rémond.com and enter your integration token and your table's ID.

A URL will be generated, and from that URL, you can create a widget. Just choose the attribute to display, the type of widget you want, etc... and click "Generate link".

Copy the generated URL, go to your Notion page, type /embed and paste your widget URL, and that's it ! You should see your widget in your Notion page.

For a more detailed guide (including how to create your own Notion integration), please check the Documentation.

FAQ

❓ Why should I use Clothion ? Isn’t there a better alternative ?

There is many existing tools for embedding a chart in your Notion page. But each of them has some negative side. For example :

• GRID : Free tier is limited to 3 docs, logo is included in the embed.
• Google Sheet : Can’t pull data from a Notion table.
• Databox : Free tier is limited to 3 databoards.
• Notion2Charts : Free tier is limited to 1 chart.
• NotionVIP : Can’t pull data from a Notion table.
• Fibery : Logo & report title is included in the embed.

❓ Is my data safe with Clothion ?

Yes, your data is safe.

Clothion is open-source, everyone can check the source code and raise concern over potential security issues.

If privacy is a hard requirement for you, you can always self-host Clothion : see Self hosting

Self-host

Clothion provides a Dockerfile, so it's super easy to run your own instance.

First, clone the repository :

git clone https://github.com/astariul/clothion.git
cd clothion

Then create the database with alembic :

mkdir ~/data
pip install alembic
CLOTHION_DB_PATH="~/data/clothion.sql" alembic upgrade head

And finally build the Docker image and run it :

docker build -t clothion .
docker run -p 9910:9910 -v ~/data:/clothion/data -e CLOTHION_DB_PATH="/clothion/data/clothion.sql" clothion

Make sure to check the Documentation for more details !

Contribute

To contribute, install the package locally, create your own branch, add your code (and tests, and documentation), and open a PR !

Pre-commit hooks

Pre-commit hooks are set to check the code added whenever you commit something.

If you never ran the hooks before, install it with :

pre-commit install

---

Then you can just try to commit your code. If your code does not meet the quality required by linters, it will not be committed. You can just fix your code and try to commit again !

---

You can manually run the pre-commit hooks with :

pre-commit run --all-files

Tests

When you contribute, you need to make sure all the unit-tests pass. You should also add tests if necessary !

You can run the tests with :

pytest

---

You can generate an HTML code report by running :

pytest --cov-report=html

And then open the file htmlcov/index.html in your browser !

---

Tests are not included in the pre-commit hooks, because running the tests might be slow, and for the sake of developpers we want the pre-commit hooks to be fast !

Pre-commit hooks will not run the tests, but it will automatically update the coverage badge !