dashSage

Make your new tab page whatever you want it to be without writing any code.

Features

• Uses Manifest v3
• Use npm dependencies thanks to Parcel 2.
• Auto-syncing options.
• Auto-publishing with auto-versioning and support for manual releases.

Getting started

🛠 Build locally

1. Checkout the copied repository to your local machine eg. with git clone https://github.com/my-username/my-awesome-extension/
2. Run npm install to install all required dependencies
3. Run npm run build

The build step will create the distribution folder, this folder will contain the generated extension.

🏃 Run the extension

Using web-ext is recommended for automatic reloading and running in a dedicated browser instance. Alternatively you can load the extension manually (see below).

1. Run npm run watch to watch for file changes and build continuously
2. Run npm install --global web-ext (only only for the first time)
3. In another terminal, run web-ext run -t chromium
4. Check that the extension is loaded by opening the extension options (in Firefox or in Chrome).

Manually

You can also load the extension manually in Chrome or Firefox.

✏️ Make the first change

1. For example, edit source\manifest.json to "name": "My Awesome Extension",
2. Go back to your browser, reload and see the change take effect

Note: Firefox will automatically reload content scripts when the extension is updated, Chrome requires you to reload the page to reload the content scripts.

📕 Read the documentation

Here are some websites you should refer to:

• Parcel’s Web Extension transformer documentation
• Chrome extensions’ API list
• A lot more links in my Awesome WebExtensions list

Configuration

The extension doesn't target any specific ECMAScript environment or provide any transpiling by default. The extensions output will be the same ECMAScript you write. This allows us to always target the latest browser version, which is a good practice you should be following.

Parcel 2

Being based on Parcel 2 and its WebExtension transformer, you get all the good parts:

• Browserlist-based code transpiling (which defaults to just the latest Chrome and Firefox versions)
• Automatically picks up any new file specified in manifest.json

Auto-syncing options

Options are managed by [fregante/webext-options-sync][link-options-sync], which auto-saves and auto-restores the options form, applies defaults and runs migrations.

Credits

Icons (FontAwesome)

Many icons have been acquired and/or modified from Ian McKenize's purchased commercial license in 2024:

---

Font Awesome Pro 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2024 Fonticons, Inc.

---

appSage

This extension is essentially an appSage wrapper for the new tab page: https://github.com/curiousmarkingsco/appSage