Skip to content

Commit c6ff2e7

Browse files
committed
feat: rework entire repository to push notion-toolbox in new direction
- Alfred and bitbar tools are removed (for now) as things get reworked. - Stripped the server of functionality that was for the tailored weekly template. - Added a notice about the weekly template at top of the repo (pointing to a previous revision of the repo). - The server tool no longer is there to support the idea of the weekly template. Instead, things are more flexible in terms of what you can do with the server (i.e., specifying CRUD actions for specified blocks/collections. The server now expects a Notion-Token in the header so it can perform operations using the provided token. - Switched the notion-py dependency back to jamalex's version. - The shared/notionscripts was reworked to be more simple in terms of what it does
1 parent 63d8bf1 commit c6ff2e7

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

51 files changed

+90
-5151
lines changed

.gitignore

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,3 @@
1-
##### CUSTOM #####
2-
alfred/data/config.json
3-
alfred/data/tags.json
4-
51
##### PYTHON #####
62
# Byte-compiled / optimized / DLL files
73
__pycache__/

README.md

Lines changed: 11 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -8,22 +8,23 @@
88
</a>
99
</p>
1010

11-
This is a collection of [Notion](https://www.notion.so/) tools that work in tandem together. All of these tools take advantage of a [specific weekly/daily template](https://kevinjalbert.com/my-weekly-notion-setup/) that integrates with various tools and solutions present in this repository.
11+
> NOTE: If you are interested in the Notion tooling around the [Notion Weekly Template](https://kevinjalbert.com/my-weekly-notion-setup/) from [kevinjalbert.com](https://kevinjalbert.com/) then you should look at the historic [snapshot of the repository](https://github.com/kevinjalbert/notion-toolbox/tree/63d8bf16670b44ec355132d5f251e0728fc5cd78). This project no longer uses the tailored template, and instead is moving in a more flexible direction.
12+
13+
This is a collection of [Notion](https://www.notion.so/) tools that work in tandem together.
1214

1315
## Tools
1416

1517
The following tools are available. Each tool has a README file present in its corresponding sub-directory.
1618

17-
- [Alfred](alfred/) workflow
18-
- Enables a handful of ways to interact with the template using shortcuts
19-
- [BitBar](bitbar/) plugin
20-
- Displays the current task in your menubar (with quick access to the Notion page)
2119
- [Server](server/) application
22-
- Enables an online (and backgrounded) interface to interact with the template
20+
- Provides a REST API to perform CRUD operations with blocks and collections
2321
- Useful to connect with webhooks (e.g., IFTTT)
24-
- Opens integrations with Google Assistant
22+
- Opens integrations with Google Assistant, iOS Shortcuts, and Android Tasker
23+
2524

26-
## History
25+
## History of this Repository
26+
<details>
27+
<summary>Toggle to read about this...</summary>
2728

2829
For a good part of 2019, I focused heavily on my [Notion[Referral]](https://www.notion.so/?r=6b8d609eb50943419db4d87c67fa558e) setup. I personally feel that this was time well invested, akin to a craftsman refining his tools.
2930

@@ -32,17 +33,8 @@ For a good part of 2019, I focused heavily on my [Notion[Referral]](https://www.
3233
- I created a server web application called [`notion-heroku`](https://github.com/kevinjalbert/notion-heroku) that interacts with [IFTTT](https://ifttt.com/) and Google Assistant ([blog post](https://kevinjalbert.com/integrating-notion-with-google-assistant/)).
3334
- I created a shared repository called [`notion-scripts`](https://github.com/kevinjalbert/notion-scripts) to further help the development of my tooling for Notion ([blog post](https://kevinjalbert.com/introducing-notion-scripts/)).
3435

35-
I recently made the decision to consolidate all my Notion related projects into a single repository. The goal is to increase cohesion to allow the tools to better interact with each other. It also puts everything in one place instead of spreading it out over multiple repositories. This approach does increase the size of the repository and the deployment/usage complexity for certain tools, but overall I feel that this decision will result in an easier way to use and develop with the Notion tools found there.
36-
37-
### The Great Merge
38-
39-
The great merge happened on December 27, 2019. On GitHub, `notion-heroku` and `notion-scripts` were merged into `alfred-notion`. I decided for `alfred-notion` to be the main repository as it had the most _stars_ on GitHub and was the longest-tenured repository I have for Notion tools. I did rename the repository to [`notion-toolbox`](https://github.com/kevinjalbert/notion-toolbox) to better represent the mission and contents of this project. Fortunately, GitHub automatically handles the redirects from `alfred-notion` to `notion-toolbox`.
40-
41-
I was able to retain the commit history of each project by following the approach mentioned in this article on _[How to merge two or multiple git repositories into one](https://medium.com/altcampus/how-to-merge-two-or-multiple-git-repositories-into-one-9f8a5209913f)_. This approach worked flawlessly for me, and was rather straightforward. The only thing I had to do was move each project's contents into subdirectories.
42-
43-
As for the merged repositories, I archived them following my approach listed in _[Archive Unused Repositories](https://kevinjalbert.com/archive-unused-repositories/)_ that I blogged about last year.
44-
45-
The only issue that I've hit right now is the _server_ (formerly `notion-heroku`) [expects certain files in the root directory to be deployable to Heroku](https://devcenter.heroku.com/articles/procfile#procfile-naming-and-location). I've temporarily restructured the repository so that it works, but it isn't ideal as the tool itself is bleeding outside of its sub-directory. A better solution will be found in the future.
36+
I consolidated all my Notion related projects into this repository ([`notion-toolbox`](https://github.com/kevinjalbert/notion-toolbox)), to increase the cohesion and interactions between the tools. Over time I've slowly pivoted away from the Notion template I put together, and this has led to a revamp of what I want notion-toolbox to do. The new vision is to allow for greater flexibility and to be more generic.
37+
</details>
4638

4739
## Author
4840

alfred/CHANGELOG.md

Lines changed: 0 additions & 19 deletions
This file was deleted.

alfred/README.md

Lines changed: 0 additions & 155 deletions
This file was deleted.

alfred/alfred-notion-demo.gif

-2.68 MB
Binary file not shown.

alfred/data/config.sample.json

Lines changed: 0 additions & 8 deletions
This file was deleted.

alfred/data/tags.sample.json

Lines changed: 0 additions & 15 deletions
This file was deleted.

alfred/icon.png

-32.7 KB
Binary file not shown.

0 commit comments

Comments
 (0)