Options

An options page is a dedicated settings page for your extension, accessible from the Chrome extensions menu.

Add an options page

In Settings → Surfaces, click Options. ChromeShip scaffolds the page, registers the manifest, and restarts the runtime.

Edit the options page

Open src/app/options/App.tsx. Build your settings UI with shadcn and Tailwind.

import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";
import { getStorageValue, setStorageValue } from "@/shared/storage";

export default function OptionsApp() {
  return (
    <div className="mx-auto max-w-2xl p-8">
      <h1 className="text-2xl font-semibold">Settings</h1>
      <p className="mt-2 text-muted-foreground">Configure your extension preferences.</p>
    </div>
  );
}

When to use options

Use an options page for settings that users change infrequently: API keys, preferences, account management. For quick actions, use a popup. For persistent tools, use a side panel.