Skip to content

kennypavan/gdocs-dark-mode

Repository files navigation

Dark Mode Extension for Google Workspace

A simple Chrome extension that can be installed locally and adds dark mode to Google Docs, Sheets, and Slides using color inversion.

Google Docs Google Slides Google Sheets

Features

  • Local Installation Follow the steps below to install locally.
  • Works across Google Workspace apps: Docs, Sheets, Slides
  • Lightweight: Uses CSS color inversion for minimal performance impact
  • Privacy-focused: Local installation means your data never leaves your browser
  • Toggle dark mode on/off via extension icon
  • Open-source: Look at the code. It's simple. Don't risk installing a chrome extension that's closed source

Why Local Installation?

Installing this extension locally (unpacked) rather than from the Chrome Web Store provides several advantages:

  • Enhanced security: You can inspect the source code yourself - no hidden functionality
  • No external dependencies: The extension runs entirely on your machine
  • Full control: Modify the code to suit your preferences
  • No data collection: Unlike some store extensions, this stores settings only in your local Chrome storage
  • No review delays: Install and use immediately without waiting for store approval

Installation Instructions

Step 1: Download the Extension

Clone or download this repository to your local computer.

Step 2: Prepare the Files

Ensure you have these files in your extension folder:

gdocs-dark-mode/
├── manifest.json
├── popup.html
├── popup.js
├── content.js
└── dark-mode.css (optional, for reference)

Step 3: Load in Chrome

  1. Open Chrome and navigate to chrome://extensions/
  2. Enable Developer mode by toggling the switch in the top right corner
  3. Click Load unpacked
  4. Select your gdocs-dark-mode folder
  5. The extension will now appear in your extensions list

Step 4: Use the Extension

  1. Open any Google Doc, Sheet, or Slide
  2. Click the extension icon in your Chrome toolbar
  3. Toggle dark mode on/off using the switch
  4. Your preference is automatically saved

Updating the Extension

If you make changes to the code:

  1. Go to chrome://extensions/
  2. Find your extension
  3. Click the refresh icon (circular arrow)
  4. Reload any open Google Workspace tabs

How It Works

The extension uses CSS filters to invert colors:

  • filter: invert(1) hue-rotate(180deg) inverts the entire page
  • Images and videos are re-inverted to maintain their original appearance
  • Settings are stored using Chrome's storage.sync API

Privacy

This extension:

  • Only stores your dark mode preference (on/off) locally in Chrome
  • Does not collect, transmit, or share any data
  • Does not require internet connectivity beyond loading Google Workspace
  • Has no analytics, tracking, or external API calls

License

Free to use and modify for personal use.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors