SafeTyper

A Grammarly alternative, where YOU own what you type on your keyboard.

SafeTyper is a browser extension that provides grammar and spelling suggestions powered by AI models through OpenRouter, Groq, or a local Ollama instance. Text is sent only to the provider you select, and only when you run a check. See PRIVACY_POLICY.md.

Features

• Universal Input Detection — works on any editable field across the web
• Multiple AI Providers — OpenRouter (GPT, Claude, Gemini, Llama), Groq (Llama, Gemma, Mixtral), and Ollama (local models)
• Smart Caching — reduces API calls and improves response time
• Visual Diff Display — inline highlighting of changes
• Adaptive Icon Positioning — smart placement for any input field size
• Multi-Browser — Chrome and Firefox with automated publishing
• Privacy-First — secure API key storage, rate limiting, key format validation

Quick Start

1. Install dependencies: bun install
2. (Optional) Create .env from .env.example with your API key
3. Start dev server: bun run dev (Chrome) or bun run dev:firefox (Firefox)
4. Load the extension in your browser
5. Configure your API key in the extension popup (or it auto-loads from .env in dev mode)

You'll need Bun (or Node.js 18+) and an API key from OpenRouter or Groq, or a local Ollama instance.

Development

Environment Variables

Copy .env.example to .env for dev mode:

VITE_OPENROUTER_API_KEY=sk-or-v1-...
VITE_GROQ_API_KEY=gsk_...

Keys auto-load in development only. The .env file is git-ignored.

Scripts

bun run dev              # Chrome dev server
bun run dev:firefox      # Firefox dev server
bun run build            # Build for Chrome
bun run build:firefox    # Build for Firefox
bun run zip              # Chrome distribution zip
bun run zip:firefox      # Firefox distribution zip
bun run check            # Type checking
bun run lint             # ESLint
bun run lint:fix         # ESLint with auto-fix
bun run format           # Prettier
bun run format:check     # Check formatting

Project Structure

src/
├── entrypoints/
│   ├── background.ts        # Service worker (API key injection)
│   ├── content.ts           # Content script (input detection)
│   └── popup/               # Extension popup UI (Svelte 5)
├── lib/content/
│   ├── api-client.ts        # Provider-aware API client with caching
│   ├── config.ts            # Provider configurations
│   ├── diff-engine.ts       # Text diff implementation
│   ├── dom-utils.ts         # DOM utilities & icon positioning
│   ├── state-manager.ts     # State management
│   ├── types.ts             # TypeScript definitions
│   └── ui-manager.ts        # UI manager
├── styles/                  # Content script CSS
└── assets/                  # Fonts & images

Using with Ollama

SafeTyper supports Ollama as a local, private provider — no API key needed.

Setup

1. Install Ollama and pull a model (e.g. ollama pull llama3.1)
2. Configure OLLAMA_ORIGINS to allow the browser extension to connect (see below)
3. In the SafeTyper popup, select Ollama as the provider and pick your model

Configuring OLLAMA_ORIGINS

By default, Ollama only accepts requests from localhost. Browser extensions use a different origin (chrome-extension://... or moz-extension://...), so Ollama returns 403 unless you allow those origins.

Allow extension origins, which is enough for SafeTyper on Chrome and Firefox:

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*"

OLLAMA_ORIGINS=* also works, and it allows every website to call your Ollama server. Prefer the extension-scheme value above.

Firefox's origin includes a per-install id, so a single pinned moz-extension:// URL will not match every user. The moz-extension://* pattern covers those installs. A Chrome Web Store install has a stable extension id; an unpacked developer build has a different one, so chrome-extension://* is the setting that works for both.

macOS:

launchctl setenv OLLAMA_ORIGINS "chrome-extension://*,moz-extension://*"

Then restart the Ollama application.

Linux (systemd):

sudo systemctl edit ollama

Add under [Service]:

[Service]
Environment="OLLAMA_ORIGINS=chrome-extension://*,moz-extension://*"

Then reload and restart:

sudo systemctl daemon-reload
sudo systemctl restart ollama

Windows:

Set OLLAMA_ORIGINS as a system environment variable to chrome-extension://*,moz-extension://*, then restart Ollama.

Running from the terminal (any OS):

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*" ollama serve

Custom Endpoint

The default endpoint is http://localhost:11434. If your Ollama instance runs on a different host or port, you can change it in the extension popup under the Ollama provider settings.

CI/CD

Automated publishing via GitHub Actions:

• Chrome Web Store — triggered on version tags (v*.*.*) or manual dispatch
• Firefox Add-ons (AMO) — triggered on version tags (v*.*.*) or manual dispatch

Both workflows run lint, format check, and type checking before building. See .env.example for required secrets.

Tech Stack

WXT · Svelte 5 · TypeScript · ESLint · Prettier

License

Apache 2.0 — see LICENSE