Opinionated New Tab

A dense, keyboard-first new tab dashboard for your browser.

📋 Table of Contents

• Installation
• Local Development
• License

Installation

Beta Version

For Firefox:

1. Follow Local Development.
2. Open about:debugging#/runtime/this-firefox in Firefox.
3. Click "Load Temporary Add-on..." and select the manifest.json file from the dist/firefox folder.

Local Development

Prerequisites

Before beginning, install pnpm globally (if not already installed):

npm install -g pnpm

Install Dependencies

Install the required dependencies for the project:

pnpm install

Development

To develop for Firefox, set the TARGET_BROWSER environment variable before running the dev server:

export TARGET_BROWSER=firefox  # Linux/macOS
set TARGET_BROWSER=firefox     # Windows (Command Prompt)
$env:TARGET_BROWSER="firefox"  # Windows (PowerShell)

Then start the development server:

pnpm dev

This will launch Firefox with your extension loaded. The page will automatically reload whenever you make changes to your code.

Build for Production

Build for a specific browser. Each outputs to its own directory (dist/chrome or dist/firefox):

pnpm build:chrome    # → dist/chrome/
pnpm build:firefox   # → dist/firefox/
pnpm build           # → both

Linting

Run Mozilla's addons-linter against the Firefox build (requires build:firefox first):

pnpm build:firefox
pnpm lint

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

Forked from Exam Countdown Extension by Novatra.