Gitwriter - Settings

General Settings

Organization Name

Default Theme

Default Book Type

Editor Settings

Auto-save Interval (seconds)

Auto-commit drafts Automatically commit changes when saving

Enable spellcheck

AI Settings

Not configured

Configure the AI provider for this organization. If left disabled, the organization inherits its tenant’s or the platform’s provider.

Enable AI features

AI Provider

Model

Embedding model (optional)

Used for semantic search. Leave blank for the provider default.

API Key

Branding

Not configured

Customize the logo, colors, and fonts for this organization. Blank fields inherit the tenant’s or platform’s brand.

App name

Shown in the navigation bar and page titles.

Tagline

Logo

No logo — the default icon is used.

PNG/SVG, under 256 KB. Uploaded images are embedded inline.

Favicon

No favicon — the default is used.

Primary color

Secondary color

Accent color

Font family

Custom Domains

0 domains

Serve a published book from your own domain, e.g. docs.company.com.

Point the domain's DNS (an A/CNAME record) at this server, then map it to a public book below — it will be served at the domain root. TLS is handled by the reverse proxy in front of this app; the SSL status here is a record of that provisioning.

Domain	Book	SSL	Active	Actions

Git Providers

Local

Choose the default provider new books use, and configure its connection. Internal (Local) storage keeps books on this server only; a remote provider hosts each book on that forge and keeps it in sync. Available providers are gated by your platform & tenant admins.

Default provider for new books

Connection

Configure connection for

Base URL

Access Token

Namespace (owner / org)

Git username (optional)

Create repositories as private

Authentication Providers

Basic only

Configure which login methods are available for this organization. Enable Google or Microsoft to allow single sign-on. If both stay disabled, this organization inherits its tenant’s (or the platform’s) providers.

How single sign-on works

Register this application once in Google or Microsoft, paste the resulting Client ID and Client Secret below, then enable the provider. Users then get a “Continue with…” button on the sign-in page. When you register the app you must give the provider an exact redirect / callback URI — copy the ones shown for each provider below. Basic username/password login always stays available as a fallback.

Basic authentication

Username and password login against accounts stored in this platform. Recommended to keep enabled so administrators can always sign in even if an external provider is misconfigured or temporarily unavailable.

Sign in with Google

Lets anyone with a Google or Google Workspace account sign in. Create an OAuth 2.0 Client ID of type Web application in the Google Cloud console.

Credentials console Create project OAuth consent screen Docs

Register these in the Google OAuth client:

Authorized redirect URI

Authorized JavaScript origin

Step-by-step setup guide

Open the Google Cloud console and create (or pick) a project.
Configure the OAuth consent screen — choose Internal for Workspace-only, or External for any Google account.
Go to Credentials → Create credentials → OAuth client ID → Web application.
Add the Authorized redirect URI and JavaScript origin shown above.
Copy the generated Client ID and Client secret into the fields below.
Enable the switch and save. Requested scopes: openid email profile.

Google Client ID

Ends in .apps.googleusercontent.com. From the OAuth client “Client ID” field.

Google Client Secret

Shown once when you create the OAuth client (starts with GOCSPX-). Stored encrypted.

Sign in with Microsoft

Lets users sign in with a Microsoft Entra ID (Azure AD), Microsoft 365 or personal Microsoft account. Register an application in the Microsoft Entra admin center and add a Web redirect URI.

App registrations (Entra) App registrations (Azure) Docs

Register this as a Web redirect URI:

Step-by-step setup guide

Open Entra → App registrations and choose New registration.
Under Supported account types pick who may sign in (single tenant, any org, or personal accounts too).
Set Redirect URI platform to Web and paste the callback URI shown above.
From the app Overview, copy the Application (client) ID and the Directory (tenant) ID into the fields below.
Go to Certificates & secrets → New client secret, then copy its Value (not the Secret ID) below.
Under API permissions ensure the delegated Microsoft Graph scopes openid, email, profile are present (added by default).
Enable the switch and save.

Microsoft Client ID

The Application (client) ID (a GUID) from the app registration Overview page.

Microsoft Client Secret

The secret Value from Certificates & secrets (copy it immediately — it is shown only once, and secrets expire). Stored encrypted.

Directory (tenant)

The Directory (tenant) ID (a GUID) to restrict sign-in to one organization, or a keyword: common (any Microsoft account), organizations (any work/school account) or consumers (personal accounts only).

Export Presets

Reusable publishing templates — page size, fonts, cover designer, and front/back matter. The default preset is applied to exports unless a specific preset is chosen. Organizations with no presets inherit their tenant's or the platform's.

Name	Page size	Main font	Actions

Style Guide

Define tone, voice, and writing rules the AI should follow when generating or reviewing content for this organization.

Settings