feat(docs): Two-Doors home, otter-orange brand, Pagefind search, and enterprise SSO/SCIM/roles guides

Docs site redesign: Two-Doors home, otter-orange brand, Pagefind search, enterprise SSO/SCIM/roles guides.
This commit is contained in:
SnapOtter
2026-06-19 18:46:59 +08:00
committed by GitHub
parent 35222249cb
commit 91ac583e87
18 changed files with 1219 additions and 164 deletions
+19 -53
View File
@@ -1,75 +1,41 @@
import { expect, test } from "@playwright/test";
test.describe("Docs Homepage", () => {
test.describe("docs homepage (Two Doors)", () => {
test.beforeEach(async ({ page }) => {
await page.goto("/");
});
test("page loads with correct title", async ({ page }) => {
test("title contains SnapOtter", async ({ page }) => {
await expect(page).toHaveTitle(/SnapOtter/);
});
test("hero renders site name and tagline", async ({ page }) => {
await expect(page.getByText("SnapOtter").first()).toBeVisible();
await expect(page.getByText("Self-Hosted File Toolkit")).toBeVisible();
test("hero renders eyebrow, name, and value prop", async ({ page }) => {
await expect(page.getByRole("heading", { name: "SnapOtter Documentation" })).toBeVisible();
await expect(page.getByText("Self-hosted", { exact: false }).first()).toBeVisible();
await expect(
page.getByText("157 tools for image, video, audio, PDF, and data processing"),
page.getByText("running entirely on your hardware", { exact: false }),
).toBeVisible();
});
test("hero renders action buttons", async ({ page }) => {
const getStarted = page.getByRole("link", { name: "Get started", exact: true });
await expect(getStarted).toBeVisible();
await expect(getStarted).toHaveAttribute("href", /getting-started/);
const apiRef = page.getByRole("link", { name: "API reference", exact: true });
await expect(apiRef).toBeVisible();
await expect(apiRef).toHaveAttribute("href", /\/api\/rest/);
});
test("features section renders all 6 feature cards", async ({ page }) => {
const features = [
"157 Tools, 5 Modalities",
"Local AI",
"Pipelines",
"REST API",
"File Library",
"Teams & Access Control",
];
for (const feature of features) {
await expect(page.getByRole("heading", { name: feature }).first()).toBeVisible();
}
});
test("Docker quick-start code block is visible", async ({ page }) => {
test("hero shows the quick-start docker command", async ({ page }) => {
await expect(page.getByText("docker run", { exact: false }).first()).toBeVisible();
});
});
test.describe("Docs Navbar", () => {
test("renders nav links", async ({ page }) => {
await page.goto("/");
await expect(page.getByRole("link", { name: "Guide" }).first()).toBeVisible();
await expect(page.getByRole("link", { name: "API Reference" }).first()).toBeVisible();
test("renders both audience doors and a sample link in each", async ({ page }) => {
await expect(page.getByRole("heading", { name: "Self-hosting" })).toBeVisible();
await expect(page.getByRole("heading", { name: "Enterprise" })).toBeVisible();
await expect(page.getByRole("link", { name: "Quick start" })).toBeVisible();
await expect(page.getByRole("link", { name: "SCIM provisioning" })).toBeVisible();
});
test("Guide nav link navigates to getting-started", async ({ page }) => {
await page.goto("/");
test("renders the modality strip with counts", async ({ page }) => {
await expect(page.getByText("157 tools across 5 modalities")).toBeVisible();
await expect(page.getByRole("link", { name: /Image/ })).toBeVisible();
});
test("nav links work", async ({ page }) => {
await expect(page.getByRole("link", { name: "Guide" }).first()).toBeVisible();
await page.getByRole("link", { name: "Guide" }).first().click();
await expect(page).toHaveURL(/getting-started/);
await expect(page.getByRole("heading", { name: "Getting Started" })).toBeVisible();
});
test("API Reference nav link navigates to REST API", async ({ page }) => {
await page.goto("/");
await page.getByRole("link", { name: "API Reference" }).first().click();
await expect(page).toHaveURL(/\/api\/rest/);
await expect(page.getByText("REST API Reference")).toBeVisible();
});
test("logo links back to homepage", async ({ page }) => {
await page.goto("/guide/getting-started");
await page.locator(".VPNavBarTitle a, .title a").first().click();
await expect(page).toHaveURL("/");
});
});