feat: multi-forge support — adapter pattern + Gitea

.github/CODEOWNERS

@@ -1 +1,5 @@
 * @afonsojramos @bmulholland @setchy
+
+# Forge adapters — see MAINTAINERS.md
+/src/renderer/utils/forges/github/ @afonsojramos @setchy
+/src/renderer/utils/forges/gitea/  @afonsojramos @bircni

CONTRIBUTING.md

@@ -90,7 +90,18 @@ The release process is automated. Follow the steps below.
 
 ### Project Philosophy
 
-This project is a tool for monitoring new notifications from GitHub. It's not meant to be a full-featured GitHub client. We want to keep it simple and focused on that core functionality. We're happy to accept contributions that help us achieve that goal, but we're also happy to say no to things that don't. We're not trying to be everything to everyone. 
+This project is a tool for monitoring new notifications from supported Git forges. It's not meant to be a full-featured forge client. We want to keep it simple and focused on that core functionality. We're happy to accept contributions that help us achieve that goal, but we're also happy to say no to things that don't. We're not trying to be everything to everyone.
+
+#### Multi-forge support
+
+Gitify supports notifications from multiple Git forges. New forges may be added under the following conditions:
+
+- **Adapter-based:** the forge is implemented behind the `ForgeAdapter` interface in `src/renderer/utils/forges/`. No forge-specific branching outside the adapter module.
+- **Designated maintainer:** every forge has at least one named maintainer in [`MAINTAINERS.md`](./MAINTAINERS.md) who owns triage and CI for that adapter.
+- **Capability-honest UI:** features unsupported by a forge (e.g. mark-as-done) must hide gracefully, not silently no-op.
+- **No core-platform churn:** Octicons, Octokit, and the Primer Design System remain in place. Octokit is scoped to the GitHub adapter; other adapters use plain `fetch`.
+
+Currently supported forges: **GitHub** (Cloud, Enterprise Server, Enterprise Cloud with Data Residency) and **Gitea** (incl. Forgejo, Codeberg).
 
 #### Things we won't do
 
@@ -100,7 +111,7 @@ This project is a tool for monitoring new notifications from GitHub. It's not me
 * Seeing past notifications. This is a tool for monitoring new notifications, not seeing old ones, which can be seen at https://github.com/notifications.
 * Specific UX/UI changes that add options and/or visual complexity for minor workflow improvements. e.g. https://github.com/gitify-app/gitify/issues/358, https://github.com/gitify-app/gitify/issues/411 and https://github.com/gitify-app/gitify/issues/979
 * UI for something that isn't core to Gitify, and/or can be trivially done another way. e.g. https://github.com/gitify-app/gitify/issues/476 and https://github.com/gitify-app/gitify/issues/221
-* Support anything other than GitHub. Doing so would be a major undertaking that we may consider in future.
+* Add a forge adapter without a designated maintainer who will own it long-term.
 
 <!-- LINK LABELS -->
 [biome-website]: https://biomejs.dev/

MAINTAINERS.md

@@ -0,0 +1,24 @@
+# Maintainers
+
+Gitify is maintained by a small team. Each forge adapter has at least one designated maintainer responsible for triage, review, and CI for that adapter.
+
+## Core maintainers
+
+- [@setchy](https://github.com/setchy)
+- [@afonsojramos](https://github.com/afonsojramos)
+
+## Forge adapter maintainers
+
+| Forge  | Maintainer                                          | Source                                  |
+| ------ | --------------------------------------------------- | --------------------------------------- |
+| GitHub | [@setchy](https://github.com/setchy), [@afonsojramos](https://github.com/afonsojramos) | `src/renderer/utils/forges/github/` |
+| Gitea  | [@bircni](https://github.com/bircni), [@afonsojramos](https://github.com/afonsojramos) | `src/renderer/utils/forges/gitea/` |
+
+## Adding a new forge
+
+See [`CONTRIBUTING.md`](./CONTRIBUTING.md#multi-forge-support) for the policy. In short:
+
+1. Open an issue proposing the forge and volunteering as its maintainer.
+2. Implement the forge behind the `ForgeAdapter` interface in `src/renderer/utils/forges/<forge-id>/`.
+3. Register the adapter in `src/renderer/utils/forges/registry.ts`.
+4. Add yourself to the table above and to `CODEOWNERS` for the adapter directory.

README.md

@@ -17,6 +17,26 @@
 - ⚡ Fast, native experience
 
 
+## Supported forges
+
+Gitify uses a forge adapter pattern (see [`MAINTAINERS.md`](MAINTAINERS.md)) so notifications can come from any compatible Git forge, not just GitHub.
+
+| Forge                                           | Status         | Notifications | Mark read | Mark done | Unsubscribe | Enriched details |
+| ----------------------------------------------- | -------------- | :-----------: | :-------: | :-------: | :---------: | :--------------: |
+| **GitHub** Cloud                                | ✅ Supported   | ✅            | ✅        | ✅        | ✅          | ✅               |
+| **GitHub** Enterprise Server (≥ 3.13)           | ✅ Supported   | ✅            | ✅        | ✅        | ✅          | ✅               |
+| **GitHub** Enterprise Cloud with Data Residency | ✅ Supported   | ✅            | ✅        | ✅        | ✅          | ✅               |
+| **Gitea** (incl. Forgejo, Codeberg)             | ✅ Supported   | ✅            | ✅        | —         | —           | —                |
+| **GitLab** (todos)                              | 💭 Considering | —             | —         | —         | —           | —                |
+| **Bitbucket** Cloud                             | 💭 Considering | —             | —         | —         | —           | —                |
+| **Azure DevOps**                                | 💭 Considering | —             | —         | —         | —           | —                |
+| **Gerrit**                                      | 💭 Considering | —             | —         | —         | —           | —                |
+
+**Status legend:** ✅ Supported · 🧪 Experimental (rough edges expected) · 🚧 In progress (adapter is being worked on) · 💭 Considering (open to a maintainer picking it up).
+
+A new forge needs an [adapter](src/renderer/utils/forges/) plus a designated maintainer — see [the contributing guide](CONTRIBUTING.md#multi-forge-support) for the full policy.
+
+
 ## Quick Start
 
 1. **Download** Gitify for free from [gitify.io][website].

codegen.ts

@@ -22,16 +22,16 @@ const config: CodegenConfig = {
       },
     },
   },
-  documents: ['src/renderer/utils/api/**/*.graphql'],
+  documents: ['src/renderer/utils/forges/github/**/*.graphql'],
   generates: {
-    'src/renderer/utils/api/graphql/generated/graphql.ts': {
+    'src/renderer/utils/forges/github/graphql/generated/graphql.ts': {
       plugins: ['typescript-operations', 'typed-document-node'],
       config: {
         documentMode: 'string',
         // enumType: 'native',
         scalars: {
           DateTime: 'string',
-          URI: '../../../../types#Link',
+          URI: '../../../../../types#Link',
         },
         useTypeImports: true,
       },

src/renderer/__mocks__/account-mocks.ts

@@ -12,6 +12,7 @@ import { getRecommendedScopeNames } from '../utils/auth/scopes';
 import { mockGitifyUser } from './user-mocks';
 
 export const mockGitHubAppAccount: Account = {
+  forge: 'github',
   platform: 'GitHub Cloud',
   method: 'GitHub App',
   token: 'token-987654321' as Token,
@@ -21,6 +22,7 @@ export const mockGitHubAppAccount: Account = {
 };
 
 export const mockPersonalAccessTokenAccount: Account = {
+  forge: 'github',
   platform: 'GitHub Cloud',
   method: 'Personal Access Token',
   token: 'token-123-456' as Token,
@@ -30,6 +32,7 @@ export const mockPersonalAccessTokenAccount: Account = {
 };
 
 export const mockOAuthAccount: Account = {
+  forge: 'github',
   platform: 'GitHub Enterprise Server',
   method: 'OAuth App',
   token: 'token-1234568790' as Token,
@@ -39,6 +42,7 @@ export const mockOAuthAccount: Account = {
 };
 
 export const mockGitHubCloudAccount: Account = {
+  forge: 'github',
   platform: 'GitHub Cloud',
   method: 'Personal Access Token',
   token: 'token-123-456' as Token,
@@ -48,13 +52,23 @@ export const mockGitHubCloudAccount: Account = {
 };
 
 export const mockGitHubEnterpriseServerAccount: Account = {
+  forge: 'github',
   platform: 'GitHub Enterprise Server',
   method: 'Personal Access Token',
   token: 'token-1234568790' as Token,
   hostname: 'github.gitify.io' as Hostname,
   user: mockGitifyUser,
 };
 
+export const mockGiteaAccount: Account = {
+  forge: 'gitea',
+  platform: 'Gitea',
+  method: 'Personal Access Token',
+  token: 'token-gitea' as Token,
+  hostname: 'gitea.example.com' as Hostname,
+  user: mockGitifyUser,
+};
+
 export function mockAccountWithError(error: GitifyError): AccountNotifications {
   return {
     account: mockGitHubCloudAccount,

src/renderer/__mocks__/notifications-mocks.ts

@@ -16,6 +16,7 @@ import {
 } from '../types';
 
 import {
+  mockGiteaAccount,
   mockGitHubAppAccount,
   mockGitHubCloudAccount,
   mockGitHubEnterpriseServerAccount,
@@ -218,6 +219,12 @@ export const mockGithubEnterpriseGitifyNotifications: GitifyNotification[] = [
 export const mockGitifyNotification: GitifyNotification =
   mockGitHubCloudGitifyNotifications[0];
 
+/** Same shape as cloud notification, but bound to a Gitea account. */
+export const mockGiteaGitifyNotification: GitifyNotification = {
+  ...mockGitifyNotification,
+  account: mockGiteaAccount,
+};
+
 export const mockMultipleAccountNotifications: AccountNotifications[] = [
   {
     account: mockGitHubCloudAccount,

src/renderer/components/notifications/NotificationRow.test.tsx

@@ -2,7 +2,10 @@ import { screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 
 import { renderWithProviders } from '../../__helpers__/test-utils';
-import { mockGitifyNotification } from '../../__mocks__/notifications-mocks';
+import {
+  mockGiteaGitifyNotification,
+  mockGitifyNotification,
+} from '../../__mocks__/notifications-mocks';
 import { mockSettings } from '../../__mocks__/state-mocks';
 
 import { GroupBy } from '../../types';
@@ -260,5 +263,18 @@ describe('renderer/components/notifications/NotificationRow.tsx', () => {
 
       expect(unsubscribeNotificationMock).toHaveBeenCalledTimes(1);
     });
+
+    it('should not show unsubscribe for Gitea notifications', () => {
+      const props: NotificationRowProps = {
+        notification: mockGiteaGitifyNotification,
+        isRepositoryAnimatingExit: false,
+      };
+
+      renderWithProviders(<NotificationRow {...props} />);
+
+      expect(
+        screen.queryByTestId('notification-unsubscribe-from-thread'),
+      ).not.toBeInTheDocument();
+    });
   });
 });

src/renderer/components/notifications/NotificationRow.tsx

@@ -10,7 +10,10 @@ import { HoverGroup } from '../primitives/HoverGroup';
 
 import { type GitifyNotification, Opacity, Size } from '../../types';
 
-import { isMarkAsDoneFeatureSupported } from '../../utils/api/features';
+import {
+  isMarkAsDoneFeatureSupported,
+  isUnsubscribeThreadSupported,
+} from '../../utils/api/features';
 import { isGroupByDate } from '../../utils/notifications/group';
 import { shouldRemoveNotificationsFromState } from '../../utils/notifications/remove';
 import { openNotification } from '../../utils/system/links';
@@ -154,6 +157,7 @@ export const NotificationRow: FC<NotificationRowProps> = ({
 
           <HoverButton
             action={actionUnsubscribeFromThread}
+            enabled={isUnsubscribeThreadSupported(notification.account)}
             icon={BellSlashIcon}
             label="Unsubscribe from thread"
             testid="notification-unsubscribe-from-thread"

src/renderer/context/App.test.tsx

@@ -275,6 +275,7 @@ describe('renderer/context/App.tsx', () => {
         'GitHub App',
         'token',
         'github.com',
+        'github',
       );
     });
 

src/renderer/context/App.tsx

@@ -21,6 +21,7 @@ import type {
   Account,
   AccountNotifications,
   AuthState,
+  Forge,
   GitifyError,
   GitifyNotification,
   Hostname,
@@ -36,8 +37,6 @@ import type {
   LoginPersonalAccessTokenOptions,
 } from '../utils/auth/types';
 
-import { fetchAuthenticatedUserDetails } from '../utils/api/client';
-import { clearOctokitClientCache } from '../utils/api/octokit';
 import {
   exchangeAuthCodeForAccessToken,
   performGitHubWebOAuth,
@@ -48,10 +47,12 @@ import {
   addAccount,
   getAccountUUID,
   hasAccounts,
+  isValidHostname,
   refreshAccount,
   removeAccount,
 } from '../utils/auth/utils';
 import { clearState, loadState, saveState } from '../utils/core/storage';
+import { getAdapter, isKnownForge } from '../utils/forges/registry';
 import {
   applyKeyboardShortcut,
   decryptValue,
@@ -72,6 +73,34 @@ import {
 import { zoomLevelToPercentage, zoomPercentageToLevel } from '../utils/ui/zoom';
 import { defaultAuth, defaultSettings } from './defaults';
 
+/**
+ * Sanitise persisted auth state. Persisted JSON is untrusted (XSS, malicious
+ * extension, file-system tampering), so we project only the known fields,
+ * coerce `forge` to a registered value, and drop accounts with a
+ * structurally invalid hostname before the renderer ever touches them.
+ */
+function migrateLegacyAuthState(auth: AuthState): AuthState {
+  return {
+    ...auth,
+    accounts: auth.accounts.flatMap((a) => {
+      if (!a.hostname || !isValidHostname(a.hostname)) {
+        return [];
+      }
+      const sanitised: Account = {
+        forge: isKnownForge(a.forge) ? a.forge : 'github',
+        method: a.method,
+        platform: a.platform,
+        version: a.version,
+        hostname: a.hostname,
+        token: a.token,
+        user: a.user,
+        scopes: a.scopes,
+      };
+      return [sanitised];
+    }),
+  };
+}
+
 export interface AppContextState {
   auth: AuthState;
   isLoggedIn: boolean;
@@ -130,7 +159,7 @@ export const AppProvider = ({ children }: { children: ReactNode }) => {
 
   const [auth, setAuth] = useState<AuthState>(
     existingState.auth
-      ? { ...defaultAuth, ...existingState.auth }
+      ? migrateLegacyAuthState({ ...defaultAuth, ...existingState.auth })
       : defaultAuth,
   );
 
@@ -473,7 +502,13 @@ export const AppProvider = ({ children }: { children: ReactNode }) => {
         await removeAccountNotifications(existingAccount);
       }
 
-      const updatedAuth = await addAccount(auth, 'GitHub App', token, hostname);
+      const updatedAuth = await addAccount(
+        auth,
+        'GitHub App',
+        token,
+        hostname,
+        'github',
+      );
 
       persistAuth(updatedAuth);
       await fetchNotifications({ auth: updatedAuth, settings });
@@ -507,6 +542,7 @@ export const AppProvider = ({ children }: { children: ReactNode }) => {
         'OAuth App',
         token,
         authOptions.hostname,
+        'github',
       );
 
       persistAuth(updatedAuth);
@@ -525,15 +561,20 @@ export const AppProvider = ({ children }: { children: ReactNode }) => {
    * Login with Personal Access Token (PAT).
    */
   const loginWithPersonalAccessToken = useCallback(
-    async ({ token, hostname }: LoginPersonalAccessTokenOptions) => {
+    async ({ token, hostname, forge }: LoginPersonalAccessTokenOptions) => {
+      const resolvedForge: Forge = forge ?? 'github';
       const encryptedToken = (await encryptValue(token)) as Token;
-      await fetchAuthenticatedUserDetails({
+      await getAdapter(resolvedForge).fetchAuthenticatedUser({
+        forge: resolvedForge,
         hostname,
         token: encryptedToken,
       } as Account);
 
       const existingAccount = auth.accounts.find(
-        (a) => a.hostname === hostname && a.method === 'Personal Access Token',
+        (a) =>
+          a.hostname === hostname &&
+          a.method === 'Personal Access Token' &&
+          a.forge === resolvedForge,
       );
       if (existingAccount) {
         await removeAccountNotifications(existingAccount);
@@ -544,6 +585,7 @@ export const AppProvider = ({ children }: { children: ReactNode }) => {
         'Personal Access Token',
         token,
         hostname,
+        resolvedForge,
       );
 
       persistAuth(updatedAuth);
@@ -564,8 +606,8 @@ export const AppProvider = ({ children }: { children: ReactNode }) => {
 
       const updatedAuth = removeAccount(auth, account);
 
-      // Clear Octokit client cache when removing account
-      clearOctokitClientCache();
+      // Drop any forge-specific HTTP client state for the logged-out account.
+      getAdapter(account).onAccountTokenChange?.(account);
 
       persistAuth(updatedAuth);
     },