An open source Chrome extension that shows your bookmarks when you open a new tab.
Built with Create React App and TypeScript.
I initially built this extension just for personal use and for trying building a Chrome extension, so it has just the feature that I need for now...
PRs are welcome!
Check the DEVLOG to see the history of the project.
- Shows your bookmarks in the new tab page
- Bookmarks filtering/search
- Keyboard navigation support
- Bookmark folders visibility toggle
- Themes support
- Drag & drop bookmark sorting
- React (using Create React App) and hooks
- Redux, Redux-Saga and Typesafe-Actions
I already created a few issues with some features that I feel like would be really welcomed addition, and I'm open to any other additional suggestion... especially if you already have an idea to implement it's UI/UX.
This is a standard Create React App, so you can easily start working on it by simply cloning the project and running
yarn to install all its dependencies.
To develop the app locally you can run
yarn start, I already included some fake bookmarks to simulate the production behaviour of the extension.
This app uses TypeScript, React Hooks, Redux and Styled-Components, so you might need to be confortable with these technologies to completely understand the codebase.
The app is still pretty simple, doesn't have too many components and most of the logic is just in the Chrome Bookmarks parsing and in the Redux sagas.
If you feel intimidated by the codebase please just open an issue/send a PR, I'm open to discussion and tips.
Also, if you're not confortable with hooks feel free to use class components.
Chrome Web Store deployment
I setup a semi-automated Chrome Web Store deployment using CircleCI.
It currently runs only when the
master branch receives a new push, but I still haven't automated the version number bumping (so I still have to do it manually).
It would be great making the publishing step manipulate the
manifest.json so that it reflects the
package.json version and/or a git tag.
Live example deployment
The "live example" is just a customized version of the production build of the app deployed on GitHub Pages.
If you check the
gh-pages script in the
package.json you'll see that I'm setting a
REACT_APP_IS_LIVE_EXAMPLE environment variable before running the GitHub Pages deployment: this will allow the build to use the fake bookmarks instead of trying to get them from the Chrome API (like if it was an extension running in the browser).
If the app starts getting contributions I'll gladly create a new ad-hoc organization for it, instead of keeping it in my personal profile.