Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ephraimduncan/minimal.so/llms.txt

Use this file to discover all available pages before exploring further.

Install the Minimal Chrome Extension to save bookmarks directly from your browser.

​
Install from Chrome Web Store

The Chrome Web Store listing is coming soon. For now, follow the development installation steps below.

​
Development Installation

For developers or early testers, you can install the extension in development mode.
1

Get the Extension Files

Clone the Minimal repository or download the extension folder:
git clone https://github.com/yourusername/minimal.git
cd minimal/extension
2

Install Dependencies

Install the required dependencies:
bun install
3

Open Chrome Extensions

Navigate to chrome://extensions/ in your Chrome browser
4

Enable Developer Mode

Toggle “Developer mode” in the top right corner
5

Load Unpacked Extension

Click “Load unpacked” and select the extension folder from the project
6

Copy Extension ID

Copy the extension ID shown under the extension name. You’ll need this for server configuration.

​
Server Configuration (Self-Hosting)

If you’re self-hosting Minimal or running a local development server, you need to configure the server to accept requests from your extension.
1

Add Extension ID to Environment

Add the extension ID to your .env file:
CHROME_EXTENSION_ID=your-extension-id-here
2

Restart the Server

Restart your Minimal server for the changes to take effect:
bun run dev
The server validates all extension requests using the extension ID. Without this configuration, bookmark saves will fail with a 403 Forbidden error.

​
Verify Installation

To verify the extension is working correctly:
  1. Check the Icon: The Minimal icon should appear in your browser toolbar
  2. Test a Save: Click the icon on any page. You should see a notification confirming the save
  3. Check Minimal: Visit your Minimal dashboard to see the saved bookmark

​
Update the Extension

When updates are available:

​
Chrome Web Store Version

  • Extensions update automatically
  • You can manually check for updates at chrome://extensions/

​
Development Version

  1. Pull the latest changes from the repository
  2. Go to chrome://extensions/
  3. Click the refresh icon on the Minimal extension card

​
Troubleshooting

​
Extension Not Saving Bookmarks

Make sure you’re logged in to Minimal. Open https://minimal.so (or your self-hosted URL) and verify you’re signed in.
If you’re self-hosting, ensure the CHROME_EXTENSION_ID environment variable is set correctly and the server has been restarted.
Right-click the extension icon, select “Inspect popup”, and check the console for error messages.
Go to chrome://extensions/, find the Minimal extension, and click “service worker” to view background script logs.

​
Auto-Capture Not Working

If X/Twitter bookmark capture or browser bookmark sync isn’t working:
  1. Verify the extension has the required permissions at chrome://extensions/
  2. Check service worker logs for error messages
  3. Ensure you’re logged in to Minimal
  4. For X capture: Make sure you’re bookmarking actual tweets (not profiles, lists, or search pages)

Build docs developers (and LLMs) love

Get started for freeTalk to us