clickhouse store

scheduled cleanup
page analytics retention
2026-08-22 20:11:05 +08:00 · 2026-08-20 00:07:50 +01:00 · 2026-08-14 23:14:02 +01:00 · 2026-08-14 23:12:36 +01:00 · 2026-08-14 16:20:18 +01:00 · 2026-08-14 16:19:12 +01:00
83 changed files with 1688 additions and 2050 deletions
@@ -50,9 +50,9 @@
    "katex": "0.16.40",
    "lowlight": "3.3.0",
    "mantine-form-zod-resolver": "1.3.0",
-    "mermaid": "11.16.1",
+    "mermaid": "11.15.0",
    "mitt": "3.0.1",
-    "nanoid": "3.3.17",
+    "nanoid": "3.3.8",
    "posthog-js": "1.391.2",
    "react": "19.2.7",
    "react-clear-modal": "^2.0.18",
@@ -387,8 +387,6 @@
  "Insert horizontal rule divider": "Insert horizontal rule divider",
  "Page break": "Page break",
  "Insert a page break for printing.": "Insert a page break for printing.",
-  "Footnote": "Footnote",
-  "Insert a footnote reference.": "Insert a footnote reference.",
  "Upload any image from your device.": "Upload any image from your device.",
  "Upload any video from your device.": "Upload any video from your device.",
  "Upload any audio from your device.": "Upload any audio from your device.",
@@ -40,6 +40,7 @@ import WorkspaceApiKeys from "@/ee/api-key/pages/workspace-api-keys";
 import AiSettings from "@/ee/ai/pages/ai-settings.tsx";
 import BasePage from "@/ee/base/pages/base-page.tsx";
 import AuditLogs from "@/ee/audit/pages/audit-logs.tsx";
+import PageAnalytics from "@/ee/page-analytics/pages/page-analytics.tsx";
 import VerifiedPages from "@/ee/page-verification/pages/verified-pages.tsx";
 import TemplateList from "@/ee/template/pages/template-list";
 import TemplateEditor from "@/ee/template/pages/template-editor";
@@ -127,6 +128,7 @@ export default function App() {
            <Route path={"ai"} element={<AiSettings />} />
            <Route path={"ai/mcp"} element={<AiSettings />} />
            <Route path={"audit"} element={<AuditLogs />} />
+            <Route path={"analytics"} element={<PageAnalytics />} />
            <Route path={"verifications"} element={<VerifiedPages />} />
            {!isCloud() && <Route path={"license"} element={<License />} />}
            {isCloud() && <Route path={"billing"} element={<Billing />} />}
@@ -5,7 +5,7 @@ import {
 } from "@/ee/billing/services/billing-service.ts";
 import { getSpaces } from "@/features/space/services/space-service.ts";
 import { getGroups } from "@/features/group/services/group-service.ts";
-import { QueryParams } from "@/lib/types.ts";
+import type { QueryParams } from "@/lib/types.ts";
 import { getWorkspaceMembers } from "@/features/workspace/services/workspace-service.ts";
 import { getLicenseInfo } from "@/ee/licence/services/license-service.ts";
 import { getSsoProviders } from "@/ee/security/services/security-service.ts";
@@ -14,6 +14,11 @@ import { getApiKeys } from "@/ee/api-key";
 import { getAuditLogs } from "@/ee/audit/services/audit-service";
 import { getVerificationList } from "@/ee/page-verification/services/page-verification-service";
 import { getScimTokens } from "@/ee/scim/services/scim-token-service";
+import {
+  getWorkspacePageAnalyticsDailyStats,
+  getWorkspacePageAnalyticsTopPages,
+  getWorkspacePageAnalyticsTotals,
+} from "@/ee/page-analytics/services/page-analytics-service";

 export const prefetchWorkspaceMembers = () => {
  const params: QueryParams = { limit: 100, query: "" };
@@ -100,6 +105,31 @@ export const prefetchVerifiedPages = () => {
  });
 };

+export const prefetchPageAnalytics = () => {
+  const dateRange = {
+    startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000)
+      .toISOString()
+      .slice(0, 10),
+    endDate: new Date().toISOString().slice(0, 10),
+  };
+  const listParams = { ...dateRange, cursor: undefined, limit: 10 };
+
+  queryClient.prefetchQuery({
+    queryKey: ["workspace-page-analytics-totals", dateRange],
+    queryFn: () => getWorkspacePageAnalyticsTotals(dateRange),
+  });
+
+  queryClient.prefetchQuery({
+    queryKey: ["workspace-page-analytics-top-pages", listParams],
+    queryFn: () => getWorkspacePageAnalyticsTopPages(listParams),
+  });
+
+  queryClient.prefetchQuery({
+    queryKey: ["workspace-page-analytics-daily-stats", listParams],
+    queryFn: () => getWorkspacePageAnalyticsDailyStats(listParams),
+  });
+};
+
 export const prefetchScimTokens = () => {
  queryClient.prefetchQuery({
    queryKey: ["scim-token-list", { cursor: undefined }],
@@ -15,6 +15,7 @@ import {
  IconSparkles,
  IconHistory,
  IconShieldCheck,
+  IconChartBar,
 } from "@tabler/icons-react";
 import { Link, useLocation } from "react-router-dom";
 import classes from "./settings.module.css";
@@ -38,6 +39,7 @@ import {
  prefetchWorkspaceMembers,
  prefetchAuditLogs,
  prefetchVerifiedPages,
+  prefetchPageAnalytics,
 } from "@/components/settings/settings-queries.tsx";
 import AppVersion from "@/components/settings/app-version.tsx";
 import { mobileSidebarAtom } from "@/components/layouts/global/hooks/atoms/sidebar-atom.ts";
@@ -125,6 +127,13 @@ const groupedData: DataGroup[] = [
        role: "owner",
        env: "selfhosted",
      },
+      {
+        label: "Page analytics",
+        icon: IconChartBar,
+        path: "/settings/analytics",
+        feature: Feature.PAGE_ANALYTICS,
+        role: "owner",
+      },
    ],
  },
  {
@@ -225,6 +234,9 @@ export default function SettingsSidebar() {
            case "Verified pages":
              prefetchHandler = prefetchVerifiedPages;
              break;
+            case "Page analytics":
+              prefetchHandler = prefetchPageAnalytics;
+              break;
            default:
              break;
          }
@@ -1,45 +0,0 @@
-import { describe, expect, it, beforeEach } from "vitest";
-import { render } from "@testing-library/react";
-import { HelmetProvider } from "react-helmet-async";
-import { DocumentTitle } from "./document-title.tsx";
-
-const renderTitle = (ui: React.ReactNode) =>
-  render(<HelmetProvider>{ui}</HelmetProvider>);
-
-describe("DocumentTitle", () => {
-  beforeEach(() => {
-    document.head.innerHTML = "<title>Docmost</title>";
-  });
-
-  it("appends the app name", () => {
-    renderTitle(<DocumentTitle title="Home" />);
-    expect(document.title).toBe("Home - Docmost");
-  });
-
-  it("omits the app name when asked", () => {
-    renderTitle(<DocumentTitle title="My page" withAppName={false} />);
-    expect(document.title).toBe("My page");
-  });
-
-  it("falls back to the app name without a title", () => {
-    renderTitle(<DocumentTitle />);
-    expect(document.title).toBe("Docmost");
-  });
-
-  it("never renders an empty title", () => {
-    renderTitle(<DocumentTitle title="Spaces" />);
-    const titles = Array.from(document.querySelectorAll("head > title"));
-    expect(titles.every((node) => node.textContent !== "")).toBe(true);
-  });
-
-  it("renders extra head children", () => {
-    renderTitle(
-      <DocumentTitle title="Shared">
-        <meta name="robots" content="noindex" />
-      </DocumentTitle>,
-    );
-    expect(
-      document.querySelector('head > meta[name="robots"]')?.getAttribute("content"),
-    ).toBe("noindex");
-  });
-});
@@ -1,29 +0,0 @@
-import React from "react";
-import { Helmet } from "react-helmet-async";
-import { getAppName } from "@/lib/config.ts";
-
-type DocumentTitleProps = {
-  title?: string;
-  withAppName?: boolean;
-  children?: React.ReactNode;
-};
-
-export function DocumentTitle({
-  title,
-  withAppName = true,
-  children,
-}: DocumentTitleProps) {
-  const appName = getAppName();
-
-  let documentTitle = appName;
-  if (title) {
-    documentTitle = withAppName ? `${title} - ${appName}` : title;
-  }
-
-  return (
-    <Helmet>
-      <title>{documentTitle}</title>
-      {children}
-    </Helmet>
-  );
-}
@@ -1,15 +1,17 @@
 import { Title, Text, Button, Container, Group } from "@mantine/core";
 import classes from "./error-404.module.css";
 import { Link } from "react-router-dom";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export function Error404() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("404 page not found")} />
+      <Helmet>
+        <title>{t("404 page not found")} - Docmost</title>
+      </Helmet>
      <Container className={classes.root}>
        <Title className={classes.title}>{t("404 page not found")}</Title>
        <Text c="dimmed" size="lg" ta="center" className={classes.description}>
@@ -1,3 +1,5 @@
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config.ts";
 import SettingsTitle from "@/components/settings/settings-title.tsx";
 import React from "react";
 import useUserRole from "@/hooks/use-user-role.tsx";
@@ -13,7 +15,6 @@ import { Feature } from "@/ee/features";
 import { useUpgradeLabel } from "@/ee/hooks/use-upgrade-label";
 import { isCloud } from "@/lib/config.ts";
 import { useLocation, useNavigate } from "react-router-dom";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function AiSettings() {
  const { t } = useTranslation();
@@ -39,7 +40,9 @@ export default function AiSettings() {

  return (
    <>
-      <DocumentTitle title="AI settings" />
+      <Helmet>
+        <title>AI settings - {getAppName()}</title>
+      </Helmet>
      <SettingsTitle title={t("AI settings")} />

      <Tabs color="dark" value={activeTab} onChange={handleTabChange}>
@@ -1,9 +1,10 @@
 import React, { useState } from "react";
 import { Anchor, Alert, Button, Group, Space, Text } from "@mantine/core";
 import { IconInfoCircle } from "@tabler/icons-react";
+import { Helmet } from "react-helmet-async";
 import { Trans, useTranslation } from "react-i18next";
 import SettingsTitle from "@/components/settings/settings-title";
-import { getAppUrl } from "@/lib/config";
+import { getAppName, getAppUrl } from "@/lib/config";
 import { ApiKeyTable } from "@/ee/api-key/components/api-key-table";
 import { CreateApiKeyModal } from "@/ee/api-key/components/create-api-key-modal";
 import { ApiKeyCreatedModal } from "@/ee/api-key/components/api-key-created-modal";
@@ -16,7 +17,6 @@ import { IApiKey } from "@/ee/api-key";
 import { useAtom } from "jotai";
 import { workspaceAtom } from "@/features/user/atoms/current-user-atom.ts";
 import useUserRole from "@/hooks/use-user-role.tsx";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function UserApiKeys() {
  const { t } = useTranslation();
@@ -49,7 +49,11 @@ export default function UserApiKeys() {

  return (
    <>
-      <DocumentTitle title={t("API keys")} />
+      <Helmet>
+        <title>
+          {t("API keys")} - {getAppName()}
+        </title>
+      </Helmet>

      <SettingsTitle title={t("API keys")} />

@@ -1,7 +1,9 @@
 import React, { useState } from "react";
 import { Anchor, Button, Divider, Group, Space, Text } from "@mantine/core";
+import { Helmet } from "react-helmet-async";
 import { Trans, useTranslation } from "react-i18next";
 import SettingsTitle from "@/components/settings/settings-title";
+import { getAppName } from "@/lib/config";
 import { ApiKeyTable } from "@/ee/api-key/components/api-key-table";
 import { CreateApiKeyModal } from "@/ee/api-key/components/create-api-key-modal";
 import { ApiKeyCreatedModal } from "@/ee/api-key/components/api-key-created-modal";
@@ -13,7 +15,6 @@ import { useGetApiKeysQuery } from "@/ee/api-key/queries/api-key-query.ts";
 import { IApiKey } from "@/ee/api-key";
 import useUserRole from '@/hooks/use-user-role.tsx';
 import RestrictApiToAdmins from "@/ee/api-key/components/restrict-api-to-admins";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function WorkspaceApiKeys() {
  const { t } = useTranslation();
@@ -46,7 +47,11 @@ export default function WorkspaceApiKeys() {

  return (
    <>
-      <DocumentTitle title={t("API management")} />
+      <Helmet>
+        <title>
+          {t("API management")} - {getAppName()}
+        </title>
+      </Helmet>

      <SettingsTitle title={t("API management")} />

@@ -10,9 +10,11 @@ import {
  Text,
  Tooltip,
 } from "@mantine/core";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
 import { IconSettings } from "@tabler/icons-react";
 import SettingsTitle from "@/components/settings/settings-title";
+import { getAppName } from "@/lib/config";
 import Paginate from "@/components/common/paginate";
 import { useCursorPaginate } from "@/hooks/use-cursor-paginate";
 import {
@@ -24,25 +26,8 @@ import { IAuditLogParams } from "@/ee/audit/types/audit.types";
 import { eventFilterOptions } from "@/ee/audit/lib/audit-event-labels";
 import AuditLogsTable from "@/ee/audit/components/audit-logs-table";
 import useUserRole from "@/hooks/use-user-role";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";
+import { daysToRetention, retentionToDays, RetentionUnit } from "@/ee/utils";

-type RetentionUnit = "days" | "months" | "years";
-
-function daysToRetention(days: number): { amount: number; unit: RetentionUnit } {
-  if (days >= 365 && days % 365 === 0) {
-    return { amount: days / 365, unit: "years" };
-  }
-  if (days >= 30 && days % 30 === 0) {
-    return { amount: days / 30, unit: "months" };
-  }
-  return { amount: days, unit: "days" };
-}
-
-function retentionToDays(amount: number, unit: RetentionUnit): number {
-  if (unit === "years") return amount * 365;
-  if (unit === "months") return amount * 30;
-  return amount;
-}

 export default function AuditLogs() {
  const { t } = useTranslation();
@@ -96,7 +81,11 @@ export default function AuditLogs() {

  return (
    <>
-      <DocumentTitle title={t("Audit log")} />
+      <Helmet>
+        <title>
+          {t("Audit log")} - {getAppName()}
+        </title>
+      </Helmet>

      <SettingsTitle title={t("Audit log")} />

@@ -1,3 +1,5 @@
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config.ts";
 import SettingsTitle from "@/components/settings/settings-title.tsx";
 import BillingPlans from "@/ee/billing/components/billing-plans.tsx";
 import BillingTrial from "@/ee/billing/components/billing-trial.tsx";
@@ -7,7 +9,6 @@ import React from "react";
 import BillingDetails from "@/ee/billing/components/billing-details.tsx";
 import { useBillingQuery } from "@/ee/billing/queries/billing-query.ts";
 import useUserRole from "@/hooks/use-user-role.tsx";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function Billing() {
  const { data: billing, isError: isBillingError } = useBillingQuery();
@@ -19,7 +20,9 @@ export default function Billing() {

  return (
    <>
-      <DocumentTitle title="Billing" />
+      <Helmet>
+        <title>Billing - {getAppName()}</title>
+      </Helmet>
      <SettingsTitle title="Billing" />

      <BillingTrial />
@@ -15,6 +15,7 @@ export const Feature = {
  SCIM: 'scim',
  PAGE_VERIFICATION: 'page:verification',
  AUDIT_LOGS: 'audit:logs',
+  PAGE_ANALYTICS: 'analytics:page-analytics',
  RETENTION: 'retention',
  SHARING_CONTROLS: 'sharing:controls',
  TEMPLATES: 'templates',
@@ -1,3 +1,5 @@
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config.ts";
 import SettingsTitle from "@/components/settings/settings-title.tsx";
 import React from "react";
 import useUserRole from "@/hooks/use-user-role.tsx";
@@ -7,7 +9,6 @@ import InstallationDetails from "@/ee/licence/components/installation-details.ts
 import OssDetails from "@/ee/licence/components/oss-details.tsx";
 import { useAtom } from "jotai/index";
 import { entitlementAtom } from "@/ee/entitlement/entitlement-atom";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function License() {
  const [entitlements] = useAtom(entitlementAtom);
@@ -20,7 +21,9 @@ export default function License() {

  return (
    <>
-      <DocumentTitle title="License" />
+      <Helmet>
+        <title>License - {getAppName()}</title>
+      </Helmet>
      <SettingsTitle title="License" />

      <ActivateLicenseForm />
@@ -0,0 +1,421 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+import {
+  ActionIcon,
+  Badge,
+  Button,
+  Card,
+  Group,
+  NumberInput,
+  Popover,
+  Select,
+  SimpleGrid,
+  Stack,
+  Table,
+  Text,
+  Tooltip,
+} from "@mantine/core";
+import { Helmet } from "react-helmet-async";
+import { useTranslation } from "react-i18next";
+import SettingsTitle from "@/components/settings/settings-title";
+import { getAppName } from "@/lib/config";
+import Paginate from "@/components/common/paginate";
+import { useCursorPaginate } from "@/hooks/use-cursor-paginate";
+import {
+  usePageAnalyticsRetentionQuery,
+  useUpdatePageAnalyticsRetentionMutation,
+  useWorkspacePageAnalyticsDailyStatsQuery,
+  useWorkspacePageAnalyticsTopPagesQuery,
+  useWorkspacePageAnalyticsTotalsQuery,
+} from "@/ee/page-analytics/queries/page-analytics-query";
+import { Link } from "react-router-dom";
+import { formatLocalized, useDateFnsLocale } from "@/lib/date-locale";
+import { IconSettings } from "@tabler/icons-react";
+import {
+  daysToRetention,
+  formatNumber,
+  retentionToDays,
+  RetentionUnit,
+  toISODate,
+} from "@/ee/utils";
+
+type RangePreset = "7" | "30" | "90";
+
+const DAILY_PAGE_SIZE = 10;
+
+export default function PageAnalytics() {
+  const { t } = useTranslation();
+  const locale = useDateFnsLocale();
+  const [rangePreset, setRangePreset] = useState<RangePreset>("30");
+  const [topPagesLimit, setTopPagesLimit] = useState("10");
+  const [settingsOpen, setSettingsOpen] = useState(false);
+
+  const { data: retentionData } = usePageAnalyticsRetentionQuery();
+  const updateRetention = useUpdatePageAnalyticsRetentionMutation();
+
+  const parsed = useMemo(
+    () => daysToRetention(retentionData?.retentionDays ?? 365),
+    [retentionData]
+  );
+
+  useEffect(() => {
+    if (settingsOpen) return;
+
+    setRetentionAmount(parsed.amount);
+    setRetentionUnit(parsed.unit);
+  }, [parsed]);
+
+  const [retentionAmount, setRetentionAmount] = useState<number | string>(
+    parsed.amount
+  );
+  const [retentionUnit, setRetentionUnit] = useState<RetentionUnit>(parsed.unit);
+
+  const resetRetentionForm = useCallback(() => {
+    const { amount, unit } = daysToRetention(retentionData?.retentionDays ?? 365);
+    setRetentionAmount(amount);
+    setRetentionUnit(unit);
+  }, [setRetentionAmount, setRetentionUnit, retentionData]);
+
+  const {
+    cursor: topPagesCursor,
+    goNext: goNextTopPages,
+    goPrev: goPrevTopPages,
+    resetCursor: resetTopPagesCursor,
+  } = useCursorPaginate();
+
+  const {
+    cursor: dailyCursor,
+    goNext: goNextDaily,
+    goPrev: goPrevDaily,
+    resetCursor: resetDailyCursor,
+  } = useCursorPaginate();
+
+  const dateRange = useMemo(
+    () => ({
+      startDate: toISODate(rangePreset),
+      endDate: new Date().toISOString().slice(0, 10),
+    }),
+    [rangePreset]
+  );
+
+  const topPagesParams = useMemo(
+    () => ({
+      ...dateRange,
+      cursor: topPagesCursor,
+      limit: Number(topPagesLimit),
+    }),
+    [dateRange, topPagesCursor, topPagesLimit]
+  );
+
+  const formatDate = useCallback(
+    (value?: Date | string | null) => {
+      if (!value) return "-";
+
+      const date = new Date(value);
+      if (Number.isNaN(date.getTime())) return "-";
+
+      return formatLocalized(date, "MMM dd, yyyy", "PP", locale);
+    },
+    [locale]
+  );
+
+  const dailyParams = useMemo(
+    () => ({
+      ...dateRange,
+      cursor: dailyCursor,
+      limit: DAILY_PAGE_SIZE,
+    }),
+    [dateRange, dailyCursor]
+  );
+
+  const { data: totalsData } = useWorkspacePageAnalyticsTotalsQuery(dateRange);
+  const { data: topPagesData, isLoading: isTopPagesLoading } =
+    useWorkspacePageAnalyticsTopPagesQuery(topPagesParams);
+  const { data: dailyData, isLoading: isDailyLoading } =
+    useWorkspacePageAnalyticsDailyStatsQuery(dailyParams);
+
+  const handleRangeChange = (value: RangePreset) => {
+    if (value) {
+      setRangePreset(value);
+      resetTopPagesCursor();
+      resetDailyCursor();
+    }
+  };
+
+  const handleTopPagesLimitChange = (value: string | null) => {
+    if (value) {
+      setTopPagesLimit(value);
+      resetTopPagesCursor();
+    }
+  };
+
+  return (
+    <>
+      <Helmet>
+        <title>
+          {t("Page analytics")} - {getAppName()}
+        </title>
+      </Helmet>
+
+      <SettingsTitle title={t("Page analytics")} />
+
+      <Group justify="space-between" mb="md">
+        <Select
+          value={rangePreset}
+          onChange={handleRangeChange}
+          data={[
+            { value: "7", label: t("Last 7 days") },
+            { value: "30", label: t("Last 30 days") },
+            { value: "90", label: t("Last 90 days") },
+          ]}
+          w={160}
+          size="sm"
+          allowDeselect={false}
+        />
+        <Popover
+          position="bottom-end"
+          shadow="md"
+          width={260}
+          withArrow
+          opened={settingsOpen}
+          onChange={(opened) => {
+            if (!opened) resetRetentionForm();
+            setSettingsOpen(opened);
+          }}
+        >
+          <Popover.Target>
+            <Tooltip label={t("Audit settings")}>
+              <ActionIcon
+                variant="default"
+                size="input-sm"
+                ml="auto"
+                onClick={() => setSettingsOpen((o) => !o)}
+              >
+                <IconSettings size={16} />
+              </ActionIcon>
+            </Tooltip>
+          </Popover.Target>
+          <Popover.Dropdown>
+            <Text fz="sm" fw={500} mb={4}>
+              {t("Retention")}
+            </Text>
+            <Text fz="xs" c="dimmed" mb="sm">
+              {t("Logs older than this period are automatically deleted.")}
+            </Text>
+            <Group gap="xs" wrap="nowrap" mb="sm">
+              <NumberInput
+                value={retentionAmount}
+                onChange={(val) => setRetentionAmount(val)}
+                min={1}
+                hideControls
+                size="sm"
+                w={60}
+              />
+              <Select
+                data={[
+                  { value: "days", label: t("days") },
+                  { value: "months", label: t("months") },
+                  { value: "years", label: t("years") },
+                ]}
+                value={retentionUnit}
+                onChange={(value) => {
+                  if (value === "days" || value === "months" || value === "years") {
+                    setRetentionUnit(value);
+                  }
+                }}
+                size="sm"
+                style={{ flex: 1 }}
+                comboboxProps={{ withinPortal: false }}
+              />
+            </Group>
+            <Group gap="xs" grow>
+              <Button
+                size="xs"
+                variant="default"
+                onClick={() => {
+                  resetRetentionForm();
+                  setSettingsOpen(false);
+                }}
+              >
+                {t("Cancel")}
+              </Button>
+              <Button
+                size="xs"
+                onClick={() => {
+                  const num =
+                    typeof retentionAmount === "number" ? retentionAmount : 1;
+                  const clamped = Math.max(1, num);
+                  setRetentionAmount(clamped);
+                  const days = retentionToDays(clamped, retentionUnit);
+
+                  if (days !== (retentionData?.retentionDays ?? 365)) {
+                    updateRetention.mutate({
+                      pageAnalyticsRetentionDays: Number(days),
+                    });
+                  }
+                  setSettingsOpen(false);
+                }}
+                loading={updateRetention.isPending}
+              >
+                {t("Save")}
+              </Button>
+            </Group>
+          </Popover.Dropdown>
+        </Popover>
+      </Group>
+
+      <SimpleGrid cols={{ base: 1, sm: 2, lg: 4 }} mb="md">
+        <Card withBorder radius="md" p="md">
+          <Text size="xs" c="dimmed">
+            {t("Total views")}
+          </Text>
+          <Text fw={700} fz="xl">
+            {formatNumber(totalsData?.totals.totalViews)}
+          </Text>
+        </Card>
+        <Card withBorder radius="md" p="md">
+          <Text size="xs" c="dimmed">
+            {t("Unique visitors")}
+          </Text>
+          <Text fw={700} fz="xl">
+            {formatNumber(totalsData?.totals.uniqueVisitors)}
+          </Text>
+        </Card>
+        <Card withBorder radius="md" p="md">
+          <Text size="xs" c="dimmed">
+            {t("Authenticated visitors")}
+          </Text>
+          <Text fw={700} fz="xl">
+            {formatNumber(totalsData?.totals.authenticatedVisitors)}
+          </Text>
+        </Card>
+        <Card withBorder radius="md" p="md">
+          <Text size="xs" c="dimmed">
+            {t("Shared-link views")}
+          </Text>
+          <Text fw={700} fz="xl">
+            {formatNumber(totalsData?.totals.sharedViews)}
+          </Text>
+        </Card>
+      </SimpleGrid>
+
+      <SimpleGrid cols={{ base: 1, lg: 2 }} spacing="md">
+        <Card withBorder radius="md" p="md">
+          <Group justify="space-between" mb="sm">
+            <Text fw={600}>{t("Top pages")}</Text>
+            <Group gap="xs">
+              {isTopPagesLoading && <Badge variant="light">{t("Loading")}</Badge>}
+              <Select
+                aria-label={t("Number of top pages")}
+                data={[
+                  { value: "10", label: t("Top 10") },
+                  { value: "20", label: t("Top 20") },
+                  { value: "50", label: t("Top 50") },
+                  { value: "100", label: t("Top 100") },
+                ]}
+                value={topPagesLimit}
+                onChange={handleTopPagesLimitChange}
+                w={100}
+                size="xs"
+                allowDeselect={false}
+              />
+            </Group>
+          </Group>
+          <Table striped highlightOnHover withTableBorder withColumnBorders>
+            <Table.Thead>
+              <Table.Tr>
+                <Table.Th>{t("Page")}</Table.Th>
+                <Table.Th>{t("Views")}</Table.Th>
+                <Table.Th>{t("Visitors")}</Table.Th>
+                <Table.Th>{t("Last viewed")}</Table.Th>
+              </Table.Tr>
+            </Table.Thead>
+            <Table.Tbody>
+              {(topPagesData?.items ?? []).map((item) => (
+                <Table.Tr key={item.pageId}>
+                  <Table.Td>
+                    {item.pageSlugId ? (
+                      <Link to={`/p/${item.pageSlugId}`}>
+                        {item.pageTitle || t("Untitled")}
+                      </Link>
+                    ) : (
+                      item.pageTitle || t("Untitled")
+                    )}
+                  </Table.Td>
+                  <Table.Td>{formatNumber(item.totalViews)}</Table.Td>
+                  <Table.Td>{formatNumber(item.uniqueVisitors)}</Table.Td>
+                  <Table.Td>{formatDate(item.lastViewedAt)}</Table.Td>
+                </Table.Tr>
+              ))}
+              {!isTopPagesLoading && (topPagesData?.items.length ?? 0) === 0 && (
+                <Table.Tr>
+                  <Table.Td colSpan={4}>
+                    <Text c="dimmed" size="sm">
+                      {t("No analytics data for this range.")}
+                    </Text>
+                  </Table.Td>
+                </Table.Tr>
+              )}
+            </Table.Tbody>
+          </Table>
+          {topPagesData?.items &&
+            topPagesData.items.length > 0 &&
+            (topPagesData.meta.hasPrevPage || topPagesData.meta.hasNextPage) && (
+              <Paginate
+                hasPrevPage={topPagesData.meta.hasPrevPage}
+                hasNextPage={topPagesData.meta.hasNextPage}
+                onPrev={goPrevTopPages}
+                onNext={() => goNextTopPages(topPagesData.meta.nextCursor)}
+              />
+            )}
+        </Card>
+
+        <Card withBorder radius="md" p="md">
+          <Group justify="space-between" mb="sm">
+            <Text fw={600}>{t("Daily breakdown")}</Text>
+            {isDailyLoading && <Badge variant="light">{t("Loading")}</Badge>}
+          </Group>
+          <Stack gap="xs">
+            <Table striped highlightOnHover withTableBorder withColumnBorders>
+              <Table.Thead>
+                <Table.Tr>
+                  <Table.Th>{t("Date")}</Table.Th>
+                  <Table.Th>{t("Views")}</Table.Th>
+                  <Table.Th>{t("Visitors")}</Table.Th>
+                </Table.Tr>
+              </Table.Thead>
+              <Table.Tbody>
+                {(dailyData?.items ?? []).map((item) => (
+                  <Table.Tr key={item.viewDate}>
+                    <Table.Td>{item.viewDate}</Table.Td>
+                    <Table.Td>{formatNumber(item.totalViews)}</Table.Td>
+                    <Table.Td>{formatNumber(item.uniqueVisitors)}</Table.Td>
+                  </Table.Tr>
+                ))}
+                {!isDailyLoading && (dailyData?.items.length ?? 0) === 0 && (
+                  <Table.Tr>
+                    <Table.Td colSpan={3}>
+                      <Text c="dimmed" size="sm">
+                        {t("No analytics data for this range.")}
+                      </Text>
+                    </Table.Td>
+                  </Table.Tr>
+                )}
+              </Table.Tbody>
+            </Table>
+
+            {dailyData?.items &&
+              dailyData.items.length > 0 &&
+              (dailyData.meta.hasPrevPage || dailyData.meta.hasNextPage) && (
+                <Paginate
+                  hasPrevPage={dailyData.meta.hasPrevPage}
+                  hasNextPage={dailyData.meta.hasNextPage}
+                  onPrev={goPrevDaily}
+                  onNext={() => goNextDaily(dailyData.meta.nextCursor)}
+                />
+              )}
+          </Stack>
+        </Card>
+      </SimpleGrid>
+    </>
+  );
+}
@@ -0,0 +1,73 @@
+import { keepPreviousData, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  getPageAnalyticsRetention,
+  getWorkspacePageAnalyticsDailyStats,
+  getWorkspacePageAnalyticsTopPages,
+  getWorkspacePageAnalyticsTotals,
+  updatePageAnalyticsRetention,
+} from "@/ee/page-analytics/services/page-analytics-service";
+import type { IPagination } from "@/lib/types";
+import type {
+  WorkspaceAnalyticsDailyStat,
+  WorkspaceAnalyticsListParams,
+  WorkspaceAnalyticsParams,
+  WorkspaceAnalyticsTopPage,
+  WorkspaceAnalyticsTotals,
+} from "@/ee/page-analytics/types/page-analytics.types";
+import { useTranslation } from "react-i18next";
+import { notifications } from "@mantine/notifications";
+
+export function useWorkspacePageAnalyticsTotalsQuery(
+  params?: WorkspaceAnalyticsParams,
+) {
+  return useQuery<WorkspaceAnalyticsTotals, Error>({
+    queryKey: ["workspace-page-analytics-totals", params],
+    queryFn: () => getWorkspacePageAnalyticsTotals(params),
+    placeholderData: keepPreviousData,
+  });
+}
+
+export function useWorkspacePageAnalyticsDailyStatsQuery(
+  params?: WorkspaceAnalyticsListParams,
+) {
+  return useQuery<IPagination<WorkspaceAnalyticsDailyStat>, Error>({
+    queryKey: ["workspace-page-analytics-daily-stats", params],
+    queryFn: () => getWorkspacePageAnalyticsDailyStats(params),
+    placeholderData: keepPreviousData,
+  });
+}
+
+export function useWorkspacePageAnalyticsTopPagesQuery(
+  params?: WorkspaceAnalyticsListParams,
+) {
+  return useQuery<IPagination<WorkspaceAnalyticsTopPage>, Error>({
+    queryKey: ["workspace-page-analytics-top-pages", params],
+    queryFn: () => getWorkspacePageAnalyticsTopPages(params),
+    placeholderData: keepPreviousData,
+  });
+}
+
+export function usePageAnalyticsRetentionQuery() {
+  return useQuery({
+    queryKey: ["page-analytics-retention"],
+    queryFn: () => getPageAnalyticsRetention(),
+  });
+}
+
+export function useUpdatePageAnalyticsRetentionMutation() {
+  const queryClient = useQueryClient();
+  const { t } = useTranslation();
+
+  return useMutation({
+    mutationFn: (data: { pageAnalyticsRetentionDays: number }) =>
+      updatePageAnalyticsRetention(data),
+    onSuccess: () => {
+      notifications.show({ message: t("Page analytics retention updated") });
+      queryClient.invalidateQueries({ queryKey: ["page-analytics-retention"] });
+    },
+    onError: (error) => {
+      const errorMessage = error["response"]?.data?.message;
+      notifications.show({ message: errorMessage, color: "red" });
+    },
+  });
+}
@@ -0,0 +1,43 @@
+import api from "@/lib/api-client";
+import type { IPagination } from "@/lib/types";
+import type {
+  WorkspaceAnalyticsDailyStat,
+  WorkspaceAnalyticsListParams,
+  WorkspaceAnalyticsParams,
+  WorkspaceAnalyticsTopPage,
+  WorkspaceAnalyticsTotals,
+} from "@/ee/page-analytics/types/page-analytics.types";
+
+export async function getWorkspacePageAnalyticsTotals(
+  params?: WorkspaceAnalyticsParams,
+): Promise<WorkspaceAnalyticsTotals> {
+  const req = await api.post("/page-analytics/workspace-stats", params);
+  return req.data;
+}
+
+export async function getWorkspacePageAnalyticsDailyStats(
+  params?: WorkspaceAnalyticsListParams,
+): Promise<IPagination<WorkspaceAnalyticsDailyStat>> {
+  const req = await api.post("/page-analytics/workspace-daily-stats", params);
+  return req.data;
+}
+
+export async function getWorkspacePageAnalyticsTopPages(
+  params?: WorkspaceAnalyticsListParams,
+): Promise<IPagination<WorkspaceAnalyticsTopPage>> {
+  const req = await api.post("/page-analytics/workspace-top-pages", params);
+  return req.data;
+}
+
+export async function getPageAnalyticsRetention(): Promise<{ retentionDays: number }> {
+  const req = await api.post("/page-analytics/retention");
+  return req.data;
+}
+
+export async function updatePageAnalyticsRetention(data: {
+  pageAnalyticsRetentionDays: number;
+}): Promise<{ retentionDays: number }> {
+
+  const req = await api.post("/page-analytics/retention/update", data);
+  return req.data;
+}
@@ -0,0 +1,32 @@
+import { QueryParams } from "@/lib/types";
+
+export type WorkspaceAnalyticsParams = {
+  startDate?: string;
+  endDate?: string;
+};
+
+export type WorkspaceAnalyticsListParams = WorkspaceAnalyticsParams &
+  QueryParams;
+
+export type BasicStats = {
+  totalViews: number;
+  uniqueVisitors: number;
+  authenticatedVisitors: number;
+  sharedViews: number;
+};
+
+export type WorkspaceAnalyticsDailyStat = BasicStats & {
+  viewDate: string;
+};
+
+export type WorkspaceAnalyticsTopPage = BasicStats & {
+  pageId: string;
+  pageTitle: string | null;
+  pageSlugId: string | null;
+  lastViewedAt: string | null;
+};
+
+export type WorkspaceAnalyticsTotals = {
+  range: { startDate: string; endDate: string };
+  totals: BasicStats;
+};
@@ -1,16 +1,17 @@
 import { useState, useMemo } from "react";
 import { Group, MultiSelect, Select, Space, TextInput } from "@mantine/core";
 import { useDebouncedValue } from "@mantine/hooks";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
 import { IconSearch } from "@tabler/icons-react";
 import SettingsTitle from "@/components/settings/settings-title";
+import { getAppName } from "@/lib/config";
 import Paginate from "@/components/common/paginate";
 import { useCursorPaginate } from "@/hooks/use-cursor-paginate";
 import { useVerificationListQuery } from "@/ee/page-verification/queries/page-verification-query";
 import { IVerificationListParams } from "@/ee/page-verification/types/page-verification.types";
 import VerificationListTable from "@/ee/page-verification/components/verification-list-table";
 import { useGetSpacesQuery } from "@/features/space/queries/space-query";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function VerifiedPages() {
  const { t } = useTranslation();
@@ -67,7 +68,11 @@ export default function VerifiedPages() {

  return (
    <>
-      <DocumentTitle title={t("Verified pages")} />
+      <Helmet>
+        <title>
+          {t("Verified pages")} - {getAppName()}
+        </title>
+      </Helmet>

      <SettingsTitle title={t("Verified pages")} />

@@ -1,13 +1,18 @@
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config.ts";
 import { CloudLoginForm } from "@/ee/components/cloud-login-form.tsx";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function CloudLogin() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("Login")} />
+      <Helmet>
+        <title>
+          {t("Login")} - {getAppName()}
+        </title>
+      </Helmet>

      <CloudLoginForm />
    </>
@@ -1,11 +1,14 @@
 import { SetupWorkspaceForm } from "@/features/auth/components/setup-workspace-form.tsx";
+import { Helmet } from "react-helmet-async";
 import React from "react";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";
+import { getAppName } from "@/lib/config.ts";

 export default function CreateWorkspace() {
  return (
    <>
-      <DocumentTitle title="Create Workspace" />
+      <Helmet>
+        <title>Create Workspace - {getAppName()}</title>
+      </Helmet>
      <SetupWorkspaceForm />
    </>
  );
@@ -1,4 +1,5 @@
-import { isCloud } from "@/lib/config.ts";
+import { Helmet } from "react-helmet-async";
+import { getAppName, isCloud } from "@/lib/config.ts";
 import SettingsTitle from "@/components/settings/settings-title.tsx";
 import {
  Alert,
@@ -36,7 +37,6 @@ import EnableScim from "@/ee/scim/components/enable-scim";
 import { useCursorPaginate } from "@/hooks/use-cursor-paginate";
 import Paginate from "@/components/common/paginate";
 import { IScimToken } from "@/ee/scim/types/scim-token.types";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 const SCIM_TOKEN_LIMIT = 5;

@@ -64,7 +64,9 @@ export default function Security() {

  return (
    <>
-      <DocumentTitle title="Security" />
+      <Helmet>
+        <title>Security - {getAppName()}</title>
+      </Helmet>
      <SettingsTitle title={t("Security")} />

      <EnforceMfa />
@@ -22,6 +22,8 @@ import { useTranslation } from "react-i18next";
 import { useDisclosure, useWindowEvent } from "@mantine/hooks";
 import { notifications } from "@mantine/notifications";
 import { Link, useParams } from "react-router-dom";
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config";
 import { useEditor, EditorContent } from "@tiptap/react";
 import { templateExtensions } from "@/features/editor/extensions/extensions";
 import {
@@ -42,7 +44,6 @@ import CalloutMenu from "@/features/editor/components/callout/callout-menu.tsx";
 import ColumnsMenu from "@/features/editor/components/columns/columns-menu.tsx";

 import classes from "./template-editor.module.css";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function TemplateEditor() {
  const { t } = useTranslation();
@@ -246,7 +247,11 @@ export default function TemplateEditor() {

  return (
    <>
-      <DocumentTitle title={t("Edit template")} />
+      <Helmet>
+        <title>
+          {t("Edit template")} - {getAppName()}
+        </title>
+      </Helmet>

      {editorToolbarEnabled && editor && (
        <FixedToolbar editor={editor} templateMode />
@@ -13,9 +13,11 @@ import {
 } from "@mantine/core";
 import { modals } from "@mantine/modals";
 import { IconPlus } from "@tabler/icons-react";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
 import { useNavigate } from "react-router-dom";
 import { useDisclosure } from "@mantine/hooks";
+import { getAppName } from "@/lib/config";
 import {
  useGetTemplatesQuery,
  useDeleteTemplateMutation,
@@ -29,7 +31,6 @@ import useUserRole from "@/hooks/use-user-role";
 import CreateTemplateModal from "@/ee/template/components/create-template-modal";
 import { useAtomValue } from "jotai";
 import { workspaceAtom } from "@/features/user/atoms/current-user-atom";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function TemplateList() {
  const { t } = useTranslation();
@@ -101,7 +102,11 @@ export default function TemplateList() {

  return (
    <>
-      <DocumentTitle title={t("Templates")} />
+      <Helmet>
+        <title>
+          {t("Templates")} - {getAppName()}
+        </title>
+      </Helmet>

      <Container size="900" pt="xl">
        <Group justify="space-between" mb="xl">
@@ -14,3 +14,33 @@ export function exchangeTokenRedirectUrl(
 ) {
  return getHostnameUrl(hostname) + "/api/auth/exchange?token=" + exchangeToken;
 }
+
+export type RetentionUnit = "days" | "months" | "years";
+
+export function daysToRetention(days: number): { amount: number; unit: RetentionUnit } {
+  if (days >= 365 && days % 365 === 0) {
+    return { amount: days / 365, unit: "years" };
+  }
+  if (days >= 30 && days % 30 === 0) {
+    return { amount: days / 30, unit: "months" };
+  }
+  return { amount: days, unit: "days" };
+}
+
+export function retentionToDays(amount: number, unit: RetentionUnit): number {
+  if (unit === "years") return amount * 365;
+  if (unit === "months") return amount * 30;
+  return amount;
+}
+
+export function toISODate(daysAgo: number | string): string {
+  const daysNum = Number(daysAgo);
+
+  return new Date(Date.now() - daysNum * 24 * 60 * 60 * 1000)
+    .toISOString()
+    .slice(0, 10);
+}
+
+export function formatNumber(value: number | null | undefined): string {
+  return Number(value ?? 0).toLocaleString();
+}
@@ -12,7 +12,6 @@ import {
  IconMathFunction,
  IconRotate2,
  IconSitemap,
-  IconSuperscript,
  IconTable,
  IconTag,
 } from "@tabler/icons-react";
@@ -271,12 +270,6 @@ export const MoreInsertsGroup: FC<Props> = ({ editor, templateMode }) => {
        >
          {t("Math block")}
        </Menu.Item>
-        <Menu.Item
-          leftSection={<IconSuperscript size={16} />}
-          onClick={() => editor.chain().focus().addFootnote().run()}
-        >
-          {t("Footnote")}
-        </Menu.Item>
      </Menu.Dropdown>
    </Menu>
  );
@@ -30,7 +30,6 @@ import {
  IconTag,
  IconMoodSmile,
  IconRotate2,
-  IconSuperscript,
 } from "@tabler/icons-react";
 import {
  CommandProps,
@@ -178,16 +177,6 @@ const CommandGroups: SlashMenuGroupedItemsType = {
      command: ({ editor, range }: CommandProps) =>
        editor.chain().focus().deleteRange(range).setPageBreak().run(),
    },
-    {
-      title: "Footnote",
-      description: "Insert a footnote reference.",
-      searchTerms: ["footnote", "reference", "citation", "note"],
-      icon: IconSuperscript,
-      command: ({ editor, range }: CommandProps) => {
-        editor.chain().focus().deleteRange(range).run();
-        editor.commands.addFootnote();
-      },
-    },
    {
      title: "Image",
      description: "Upload any image from your device.",
@@ -1,6 +1,5 @@
 import { markInputRule } from "@tiptap/core";
 import { StarterKit } from "@tiptap/starter-kit";
-import { Document } from "@tiptap/extension-document";
 import { Code } from "@tiptap/extension-code";
 import { TextAlign } from "@tiptap/extension-text-align";
 import { TaskList, TaskItem } from "@tiptap/extension-list";
@@ -64,9 +63,6 @@ import {
  TransclusionReference,
  TableView,
  BaseEmbed as BaseEmbedNode,
-  Footnotes,
-  Footnote,
-  FootnoteReference,
 } from "@docmost/editor-ext";
 import {
  randomElement,
@@ -136,7 +132,6 @@ lowlight.register("scala", scala);
 // @ts-ignore
 export const mainExtensions = [
  StarterKit.configure({
-    document: false,
    heading: false,
    undoRedo: false,
    link: false,
@@ -148,9 +143,6 @@ export const mainExtensions = [
    codeBlock: false,
    code: false,
  }),
-  Document.extend({
-    content: "block+ footnotes?",
-  }),
  // Override TipTap's Code extension to fix the inline code input rule.
  // The upstream regex /(^|[^`])`([^`]+)`(?!`)$/ captures the character
  // before the opening backtick as part of the match, causing markInputRule
@@ -211,8 +203,7 @@ export const mainExtensions = [
            parentName === "tableCell" ||
            parentName === "tableHeader" ||
            parentName === "callout" ||
-            parentName === "blockquote" ||
-            parentName === "footnote"
+            parentName === "blockquote"
          ) {
            return i18n.t("Write...");
          }
@@ -426,9 +417,6 @@ export const mainExtensions = [
  }).configure(),
  Columns,
  Column,
-  Footnotes,
-  Footnote,
-  FootnoteReference,
  AutoJoiner.configure({
    elementsToJoin: [],
  }),
@@ -1,26 +0,0 @@
-.ProseMirror sup a.footnote-ref {
-  color: var(--mantine-primary-color-filled);
-  text-decoration: none;
-  cursor: pointer;
-  font-weight: 600;
-}
-
-.ProseMirror sup:has(a.footnote-ref) {
-  padding: 0 1px;
-}
-
-.ProseMirror ol.footnotes {
-  margin-top: 2rem;
-  padding-top: 0.75rem;
-  font-size: 0.875rem;
-  color: var(--mantine-color-dimmed);
-  list-style-type: decimal;
-}
-
-.ProseMirror ol.footnotes:has(li) {
-  border-top: 1px solid var(--mantine-color-default-border);
-}
-
-.ProseMirror ol.footnotes li p {
-  margin: 0.15rem 0;
-}
@@ -18,4 +18,3 @@
@import "./columns.css";
@import "./status.css";
@import "./base-embed.css";
-@import "./footnotes.css";
@@ -1,10 +1,13 @@
 import { ForgotPasswordForm } from "@/features/auth/components/forgot-password-form";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";
+import { getAppName } from "@/lib/config";
+import { Helmet } from "react-helmet-async";

 export default function ForgotPassword() {
    return (
        <>
-            <DocumentTitle title="Forgot Password" />
+            <Helmet>
+                <title>Forgot Password - {getAppName()}</title>
+            </Helmet>
            <ForgotPasswordForm />
        </>
    );
@@ -1,13 +1,16 @@
+import { Helmet } from "react-helmet-async";
 import { InviteSignUpForm } from "@/features/auth/components/invite-sign-up-form.tsx";
+import {getAppName} from "@/lib/config.ts";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function InviteSignup() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("Invitation Signup")} />
+      <Helmet>
+        <title>{t("Invitation Signup")} - {getAppName()}</title>
+      </Helmet>
      <InviteSignUpForm />
    </>
  );
@@ -1,13 +1,18 @@
 import { LoginForm } from "@/features/auth/components/login-form";
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config.ts";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function LoginPage() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("Login")} />
+      <Helmet>
+        <title>
+          {t("Login")} - {getAppName()}
+        </title>
+      </Helmet>
      <LoginForm />
    </>
  );
@@ -1,10 +1,11 @@
+import { Helmet } from "react-helmet-async";
 import { PasswordResetForm } from "@/features/auth/components/password-reset-form";
 import { Link, useSearchParams } from "react-router-dom";
 import { useVerifyUserTokenQuery } from "@/features/auth/queries/auth-query";
 import { Button, Container, Group, Text } from "@mantine/core";
 import APP_ROUTE from "@/lib/app-route";
+import { getAppName } from "@/lib/config.ts";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function PasswordReset() {
  const { t } = useTranslation();
@@ -22,7 +23,11 @@ export default function PasswordReset() {
  if (isError || !resetToken) {
    return (
      <>
-        <DocumentTitle title={t("Password Reset")} />
+        <Helmet>
+          <title>
+            {t("Password Reset")} - {getAppName()}
+          </title>
+        </Helmet>
        <Container my={40}>
          <Text size="lg" ta="center">
            {t("Invalid or expired password reset link")}
@@ -44,7 +49,11 @@ export default function PasswordReset() {

  return (
    <>
-      <DocumentTitle title={t("Password Reset")} />
+      <Helmet>
+        <title>
+          {t("Password Reset")} - {getAppName()}
+        </title>
+      </Helmet>
      <PasswordResetForm resetToken={resetToken} />
    </>
  );
@@ -1,10 +1,11 @@
 import { useWorkspacePublicDataQuery } from "@/features/workspace/queries/workspace-query.ts";
 import { SetupWorkspaceForm } from "@/features/auth/components/setup-workspace-form.tsx";
+import { Helmet } from "react-helmet-async";
 import React, { useEffect } from "react";
 import { useNavigate } from "react-router-dom";
 import APP_ROUTE from "@/lib/app-route.ts";
+import { getAppName } from "@/lib/config.ts";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function SetupWorkspace() {
  const { t } = useTranslation();
@@ -34,7 +35,11 @@ export default function SetupWorkspace() {
  ) {
    return (
      <>
-        <DocumentTitle title={t("Setup Workspace")} />
+        <Helmet>
+          <title>
+            {t("Setup Workspace")} - {getAppName()}
+          </title>
+        </Helmet>
        <SetupWorkspaceForm />
      </>
    );
@@ -2,15 +2,20 @@ import { Container, Space } from "@mantine/core";
 import HomeTabs from "@/features/home/components/home-tabs";
 import HomeAiPrompt from "@/features/home/components/home-ai-prompt";
 import SpaceCarousel from "@/features/space/components/space-carousel.tsx";
+import { getAppName } from "@/lib/config.ts";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function Home() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("Home")} />
+      <Helmet>
+        <title>
+          {t("Home")} - {getAppName()}
+        </title>
+      </Helmet>
      <Container size={"900"} pt="xl">
        <HomeAiPrompt />

@@ -17,7 +17,9 @@ import {
 } from "@tabler/icons-react";
 import { Link, useParams } from "react-router-dom";
 import { useTranslation } from "react-i18next";
+import { Helmet } from "react-helmet-async";
 import { useDebouncedValue } from "@mantine/hooks";
+import { getAppName } from "@/lib/config";
 import { useLabelPagesQuery } from "@/features/label/queries/label-query.ts";
 import { useGetSpacesQuery } from "@/features/space/queries/space-query.ts";
 import { getLabelColor } from "@/features/label/utils/label-colors.ts";
@@ -27,7 +29,6 @@ import { normalizeLabelName } from "@/features/label/utils/normalize-label.ts";
 import { SpaceFilterMenu } from "@/features/space/components/space-filter-menu.tsx";
 import { EmptyState } from "@/components/ui/empty-state";
 import classes from "@/features/label/label.module.css";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function LabelPage() {
  const { t } = useTranslation();
@@ -81,7 +82,11 @@ export default function LabelPage() {

  return (
    <>
-      <DocumentTitle title={labelName} />
+      <Helmet>
+        <title>
+          {labelName} - {getAppName()}
+        </title>
+      </Helmet>

      <Container size={820} py="xl">
        <Stack gap="lg">
@@ -3,6 +3,7 @@ import { usePageQuery } from "@/features/page/queries/page-query";
 import { FullEditor } from "@/features/editor/full-editor";
 import { TitleEditor } from "@/features/editor/title-editor";
 import HistoryModal from "@/features/page-history/components/history-modal";
+import { Helmet } from "react-helmet-async";
 import PageHeader from "@/features/page/components/header/page-header.tsx";
 import { extractPageSlugId } from "@/lib";
 import { useGetSpaceBySlugQuery } from "@/features/space/queries/space-query.ts";
@@ -17,7 +18,6 @@ import { BaseView } from "@/ee/base/components/base-view";
 import { useHasFeature } from "@/ee/hooks/use-feature";
 import { Feature } from "@/ee/features";
 import { getPageTitle } from "@/features/page/page.utils";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";
 const MemoizedFullEditor = React.memo(FullEditor);
 const MemoizedTitleEditor = React.memo(TitleEditor);
 const MemoizedPageHeader = React.memo(PageHeader);
@@ -110,10 +110,9 @@ function PageContent({ pageSlug }: { pageSlug: string | undefined }) {
          paddingTop: "calc(var(--page-header-height) + 6px)",
        }}
      >
-        <DocumentTitle
-          title={`${page?.icon || ""}  ${getPageTitle(page?.title, page?.isBase, t)}`}
-          withAppName={false}
-        />
+        <Helmet>
+          <title>{`${page?.icon || ""}  ${getPageTitle(page?.title, page?.isBase, t)}`}</title>
+        </Helmet>
        <MemoizedPageHeader readOnly={!canEdit} />
        <div
          style={{
@@ -160,10 +159,9 @@ function PageContent({ pageSlug }: { pageSlug: string | undefined }) {
  return (
    page && (
      <div>
-        <DocumentTitle
-          title={`${page?.icon || ""}  ${getPageTitle(page?.title, page?.isBase, t)}`}
-          withAppName={false}
-        />
+        <Helmet>
+          <title>{`${page?.icon || ""}  ${getPageTitle(page?.title, page?.isBase, t)}`}</title>
+        </Helmet>

        <MemoizedPageHeader readOnly={!canEdit} />

@@ -5,16 +5,21 @@ import PageWidthPref from "@/features/user/components/page-width-pref.tsx";
 import PageEditPref from "@/features/user/components/page-state-pref";
 import FixedToolbarPref from "@/features/user/components/fixed-toolbar-pref";
 import NotificationPref from "@/features/user/components/notification-pref";
+import { getAppName } from "@/lib/config.ts";
 import { Divider } from "@mantine/core";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function AccountPreferences() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("Preferences")} />
+      <Helmet>
+        <title>
+          {t("Preferences")} - {getAppName()}
+        </title>
+      </Helmet>
      <SettingsTitle title={t("Preferences")} />

      <AccountTheme />
@@ -4,17 +4,22 @@ import ChangePassword from "@/features/user/components/change-password";
 import { Divider } from "@mantine/core";
 import AccountAvatar from "@/features/user/components/account-avatar";
 import SettingsTitle from "@/components/settings/settings-title.tsx";
+import { getAppName } from "@/lib/config.ts";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
 import { AccountMfaSection } from "@/features/user/components/account-mfa-section";
 import SessionList from "@/features/session/components/session-list";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function AccountSettings() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("My Profile")} />
+      <Helmet>
+        <title>
+          {t("My Profile")} - {getAppName()}
+        </title>
+      </Helmet>
      <SettingsTitle title={t("My Profile")} />

      <AccountAvatar />
@@ -1,15 +1,20 @@
 import SettingsTitle from "@/components/settings/settings-title.tsx";
 import GroupMembersList from "@/features/group/components/group-members";
 import GroupDetails from "@/features/group/components/group-details";
+import { getAppName } from "@/lib/config.ts";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function GroupInfo() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("Manage Group")} />
+      <Helmet>
+        <title>
+          {t("Manage Group")} - {getAppName()}
+        </title>
+      </Helmet>
      <SettingsTitle title={t("Manage Group")} />
      <GroupDetails />
      <GroupMembersList />
@@ -3,8 +3,9 @@ import SettingsTitle from "@/components/settings/settings-title.tsx";
 import { Group } from "@mantine/core";
 import CreateGroupModal from "@/features/group/components/create-group-modal";
 import useUserRole from "@/hooks/use-user-role.tsx";
+import {getAppName} from "@/lib/config.ts";
+import {Helmet} from "react-helmet-async";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function Groups() {
  const { t } = useTranslation();
@@ -12,7 +13,9 @@ export default function Groups() {

  return (
    <>
-      <DocumentTitle title={t("Groups")} />
+        <Helmet>
+            <title>{t("Groups")} - {getAppName()}</title>
+        </Helmet>
      <SettingsTitle title={t("Groups")} />

      <Group my="md" justify="flex-end">
@@ -1,17 +1,22 @@
 import SettingsTitle from "@/components/settings/settings-title.tsx";
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config.ts";
 import { useTranslation } from "react-i18next";
 import ShareList from "@/features/share/components/share-list.tsx";
 import { Alert, Text } from "@mantine/core";
 import { IconInfoCircle } from "@tabler/icons-react";
 import React from "react";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function Shares() {
  const { t } = useTranslation();

  return (
    <>
-      <DocumentTitle title={t("Public sharing")} />
+      <Helmet>
+        <title>
+          {t("Public sharing")} - {getAppName()}
+        </title>
+      </Helmet>
      <SettingsTitle title={t("Public sharing")} />

      <Alert variant="light" color="blue" icon={<IconInfoCircle />}>
@@ -3,8 +3,9 @@ import SpaceList from "@/features/space/components/space-list.tsx";
 import useUserRole from "@/hooks/use-user-role.tsx";
 import { Group } from "@mantine/core";
 import CreateSpaceModal from "@/features/space/components/create-space-modal.tsx";
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config.ts";
 import { useTranslation } from "react-i18next";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function Spaces() {
  const { t } = useTranslation();
@@ -12,7 +13,11 @@ export default function Spaces() {

  return (
    <>
-      <DocumentTitle title={t("Spaces")} />
+      <Helmet>
+        <title>
+          {t("Spaces")} - {getAppName()}
+        </title>
+      </Helmet>
      <SettingsTitle title={t("Spaces")} />

      <Group my="md" justify="flex-end">
@@ -6,10 +6,11 @@ import { useEffect, useState } from "react";
 import { useNavigate, useSearchParams } from "react-router-dom";
 import WorkspaceInvitesTable from "@/features/workspace/components/members/components/workspace-invites-table.tsx";
 import useUserRole from "@/hooks/use-user-role.tsx";
+import { getAppName } from "@/lib/config.ts";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
 import { useAtom } from "jotai";
 import { workspaceAtom } from "@/features/user/atoms/current-user-atom.ts";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function WorkspaceMembers() {
  const { t } = useTranslation();
@@ -37,7 +38,11 @@ export default function WorkspaceMembers() {

  return (
    <>
-      <DocumentTitle title={t("Members")} />
+      <Helmet>
+        <title>
+          {t("Members")} - {getAppName()}
+        </title>
+      </Helmet>
      <SettingsTitle title={t("Members")} />

      {/* <WorkspaceInviteSection /> */}
@@ -2,19 +2,21 @@ import SettingsTitle from "@/components/settings/settings-title.tsx";
 import WorkspaceNameForm from "@/features/workspace/components/settings/components/workspace-name-form";
 import WorkspaceIcon from "@/features/workspace/components/settings/components/workspace-icon.tsx";
 import { useTranslation } from "react-i18next";
-import { isCloud } from "@/lib/config.ts";
+import { getAppName, isCloud } from "@/lib/config.ts";
+import { Helmet } from "react-helmet-async";
 import ManageHostname from "@/ee/components/manage-hostname.tsx";
 import { Divider } from "@mantine/core";
 import AllowMemberTemplates from "@/ee/security/components/allow-member-templates.tsx";
 import WorkspaceDefaultPageEditMode from "@/features/workspace/components/settings/components/workspace-default-page-edit-mode.tsx";
 import PersonalSpacesSetting from "@/ee/personal-space/components/personal-spaces-setting.tsx";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function WorkspaceSettings() {
  const { t } = useTranslation();
  return (
    <>
-      <DocumentTitle title="Workspace Settings" />
+      <Helmet>
+        <title>Workspace Settings - {getAppName()}</title>
+      </Helmet>
      <SettingsTitle title={t("General")} />
      <WorkspaceIcon />
      <WorkspaceNameForm />
@@ -1,4 +1,5 @@
 import { useNavigate, useParams } from "react-router-dom";
+import { Helmet } from "react-helmet-async";
 import { useTranslation } from "react-i18next";
 import { useSharePageQuery } from "@/features/share/queries/share-query.ts";
 import { Container } from "@mantine/core";
@@ -13,7 +14,6 @@ import {
  sharedTreeDataAtom,
 } from "@/features/share/atoms/shared-page-atom.ts";
 import { isPageInTree } from "@/features/share/utils.ts";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function SharedPage() {
  const { t } = useTranslation();
@@ -56,14 +56,12 @@ export default function SharedPage() {

  return (
    <div>
-      <DocumentTitle
-        title={data?.page?.title || t("untitled")}
-        withAppName={false}
-      >
+      <Helmet>
+        <title>{`${data?.page?.title || t("untitled")}`}</title>
        {!data?.share.searchIndexing && (
          <meta name="robots" content="noindex" />
        )}
-      </DocumentTitle>
+      </Helmet>

      <Container fluid={fullWidth} size={fullWidth ? undefined : 900} p={0}>
        <ReadonlyPageEditor
@@ -2,7 +2,8 @@ import {Container} from "@mantine/core";
 import SpaceHomeTabs from "@/features/space/components/space-home-tabs.tsx";
 import {useParams} from "react-router-dom";
 import {useGetSpaceBySlugQuery} from "@/features/space/queries/space-query.ts";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";
+import {getAppName} from "@/lib/config.ts";
+import {Helmet} from "react-helmet-async";

 export default function SpaceHome() {
    const {spaceSlug} = useParams();
@@ -10,7 +11,9 @@ export default function SpaceHome() {

    return (
        <>
-            <DocumentTitle title={space?.name || 'Overview'} />
+            <Helmet>
+                <title>{space?.name || 'Overview'} - {getAppName()}</title>
+            </Helmet>
            <Container size={"900"} pt="xl">
                {space && <SpaceHomeTabs/>}
            </Container>
@@ -1,12 +1,13 @@
 import { Container, Title, Text, Group, Box } from "@mantine/core";
 import { useTranslation } from "react-i18next";
+import { Helmet } from "react-helmet-async";
+import { getAppName } from "@/lib/config";
 import { useGetSpacesQuery } from "@/features/space/queries/space-query";
 import CreateSpaceModal from "@/features/space/components/create-space-modal";
 import { AllSpacesList } from "@/features/space/components/spaces-page";
 import FavoriteSpacesGrid from "@/features/space/components/spaces-page/favorite-spaces-grid";
 import { usePaginateAndSearch } from "@/hooks/use-paginate-and-search";
 import useUserRole from "@/hooks/use-user-role";
-import { DocumentTitle } from "@/components/ui/document-title.tsx";

 export default function Spaces() {
  const { t } = useTranslation();
@@ -21,7 +22,11 @@ export default function Spaces() {

  return (
    <>
-      <DocumentTitle title={t("Spaces")} />
+      <Helmet>
+        <title>
+          {t("Spaces")} - {getAppName()}
+        </title>
+      </Helmet>

      <Container size={"800"} pt="xl">
        <Group justify="space-between" mb="xl">
@@ -51,19 +51,19 @@
    "@nestjs-labs/nestjs-ioredis": "11.0.4",
    "@nestjs/bullmq": "11.0.4",
    "@nestjs/cache-manager": "3.1.3",
-    "@nestjs/common": "11.1.28",
+    "@nestjs/common": "11.1.27",
    "@nestjs/config": "4.0.4",
    "@nestjs/core": "11.1.27",
    "@nestjs/event-emitter": "3.1.0",
    "@nestjs/jwt": "11.0.2",
    "@nestjs/mapped-types": "2.1.1",
    "@nestjs/passport": "11.0.5",
-    "@nestjs/platform-fastify": "11.1.28",
-    "@nestjs/platform-socket.io": "11.1.28",
+    "@nestjs/platform-fastify": "11.1.27",
+    "@nestjs/platform-socket.io": "11.1.27",
    "@nestjs/schedule": "6.1.3",
    "@nestjs/terminus": "11.1.1",
    "@nestjs/throttler": "6.5.0",
-    "@nestjs/websockets": "11.1.28",
+    "@nestjs/websockets": "11.1.27",
    "@node-saml/passport-saml": "5.1.0",
    "@socket.io/redis-adapter": "8.3.0",
    "ai": "6.0.134",
@@ -90,8 +90,8 @@
    "ldapts": "8.1.7",
    "mammoth": "1.12.0",
    "mime-types": "3.0.2",
-    "msgpackr": "1.11.9",
-    "nanoid": "5.1.16",
+    "msgpackr": "^1.11.9",
+    "nanoid": "5.1.7",
    "nestjs-cls": "6.2.0",
    "nestjs-kysely": "3.1.2",
    "nestjs-pino": "4.6.1",
@@ -102,7 +102,7 @@
    "passport-google-oauth20": "2.0.0",
    "passport-jwt": "4.0.1",
    "pg-tsquery": "8.4.2",
-    "pgvector": "0.2.1",
+    "pgvector": "^0.2.1",
    "pino-http": "11.0.0",
    "pino-pretty": "13.1.3",
    "postgres": "3.4.8",
@@ -26,6 +26,7 @@ import KeyvRedis from '@keyv/redis';
 import { LoggerModule } from './common/logger/logger.module';
 import { ClsModule } from 'nestjs-cls';
 import { NoopAuditModule } from './integrations/audit/audit.module';
+import { NoopPageAnalyticsModule } from './integrations/page-analytics/page-analytics.module';
 import { ThrottleModule } from './integrations/throttle/throttle.module';

 const enterpriseModules = [];
@@ -50,6 +51,7 @@ try {
    }),
    LoggerModule,
    NoopAuditModule,
+    NoopPageAnalyticsModule,
    CoreModule,
    DatabaseModule,
    EnvironmentModule,
@@ -1,5 +1,4 @@
 import { StarterKit } from '@tiptap/starter-kit';
-import { Document } from '@tiptap/extension-document';
 import { TextAlign } from '@tiptap/extension-text-align';
 import { Superscript } from '@tiptap/extension-superscript';
 import SubScript from '@tiptap/extension-subscript';
@@ -46,9 +45,6 @@ import {
  TransclusionSource,
  TransclusionReference,
  BaseEmbed,
-  Footnotes,
-  Footnote,
-  FootnoteReference,
 } from '@docmost/editor-ext';
 import { generateText, getSchema, JSONContent } from '@tiptap/core';
 import { generateHTML, generateJSON } from '../common/helpers/prosemirror/html';
@@ -62,15 +58,11 @@ import { Logger } from '@nestjs/common';

 export const tiptapExtensions = [
  StarterKit.configure({
-    document: false,
    codeBlock: false,
    link: false,
    trailingNode: false,
    heading: false,
  }),
-  Document.extend({
-    content: 'block+ footnotes?',
-  }),
  Heading,
  UniqueID.configure({
    types: ['heading', 'paragraph', 'transclusionSource'],
@@ -118,10 +110,7 @@ export const tiptapExtensions = [
  Status,
  TransclusionSource,
  TransclusionReference,
-  BaseEmbed,
-  Footnotes,
-  Footnote,
-  FootnoteReference,
+  BaseEmbed
 ] as any;

 export function jsonToHtml(tiptapJson: any) {
@@ -15,6 +15,7 @@ export const Feature = {
  SCIM: 'scim',
  PAGE_VERIFICATION: 'page:verification',
  AUDIT_LOGS: 'audit:logs',
+  PAGE_ANALYTICS: 'analytics:page-analytics',
  RETENTION: 'retention',
  SHARING_CONTROLS: 'sharing:controls',
  VIEWER_COMMENTS: 'comment:viewer',
@@ -42,6 +42,7 @@ function buildWorkspaceOwnerAbility() {
  can(WorkspaceCaslAction.Manage, WorkspaceCaslSubject.Attachment);
  can(WorkspaceCaslAction.Manage, WorkspaceCaslSubject.API);
  can(WorkspaceCaslAction.Manage, WorkspaceCaslSubject.Audit);
+  can(WorkspaceCaslAction.Manage, WorkspaceCaslSubject.PageAnalytics);

  return build();
 }
@@ -13,6 +13,7 @@ export enum WorkspaceCaslSubject {
  Attachment = 'attachment',
  API = 'api_key',
  Audit = 'audit',
+  PageAnalytics = 'page_analytics'
 }

 export type IWorkspaceAbility =
@@ -22,4 +23,5 @@ export type IWorkspaceAbility =
  | [WorkspaceCaslAction, WorkspaceCaslSubject.Group]
  | [WorkspaceCaslAction, WorkspaceCaslSubject.Attachment]
  | [WorkspaceCaslAction, WorkspaceCaslSubject.API]
-  | [WorkspaceCaslAction, WorkspaceCaslSubject.Audit];
+  | [WorkspaceCaslAction, WorkspaceCaslSubject.Audit]
+  | [WorkspaceCaslAction, WorkspaceCaslSubject.PageAnalytics];
@@ -51,6 +51,10 @@ import {
  AUDIT_SERVICE,
  IAuditService,
 } from '../../integrations/audit/audit.service';
+import {
+  PAGE_ANALYTICS_SERVICE,
+  IPageAnalyticsService,
+} from '../../integrations/page-analytics/page-analytics.service';
 import { getPageTitle } from '../../common/helpers';

@UseGuards(JwtAuthGuard)
@@ -65,6 +69,7 @@ export class PageController {
    private readonly backlinkService: BacklinkService,
    private readonly labelService: LabelService,
    @Inject(AUDIT_SERVICE) private readonly auditService: IAuditService,
+    @Inject(PAGE_ANALYTICS_SERVICE) private readonly pageAnalyticsService: IPageAnalyticsService,
  ) {}

  @HttpCode(HttpStatus.OK)
@@ -88,6 +93,13 @@ export class PageController {

    const permissions = { canEdit, hasRestriction };

+    void this.pageAnalyticsService.track({
+      pageId: page.id,
+      workspaceId: page.workspaceId,
+      spaceId: page.spaceId,
+      userId: user.id,
+    });
+
    if (dto.format && dto.format !== 'json' && page.content) {
      const contentOutput =
        dto.format === 'markdown'
@@ -810,10 +810,6 @@ export class PageService {
      throw new BadRequestException('Invalid move position');
    }

-    if (dto.parentPageId && dto.parentPageId === dto.pageId) {
-      throw new BadRequestException('A page cannot be its own parent');
-    }
-
    let parentPageId = null;
    if (movedPage.parentPageId === dto.parentPageId) {
      parentPageId = undefined;
@@ -35,6 +35,10 @@ import {
  AUDIT_SERVICE,
  IAuditService,
 } from '../../integrations/audit/audit.service';
+import {
+  PAGE_ANALYTICS_SERVICE,
+  IPageAnalyticsService,
+} from '../../integrations/page-analytics/page-analytics.service';

@UseGuards(JwtAuthGuard)
@Controller('shares')
@@ -47,6 +51,8 @@ export class ShareController {
    private readonly pageAccessService: PageAccessService,
    private readonly licenseCheckService: LicenseCheckService,
    @Inject(AUDIT_SERVICE) private readonly auditService: IAuditService,
+    @Inject(PAGE_ANALYTICS_SERVICE)
+    private readonly pageAnalyticsService: IPageAnalyticsService,
  ) {}

  @HttpCode(HttpStatus.OK)
@@ -79,6 +85,14 @@ export class ShareController {
      throw new NotFoundException('Shared page not found');
    }

+    void this.pageAnalyticsService.track({
+      pageId: shareData.page.id,
+      workspaceId: workspace.id,
+      spaceId: shareData.page.spaceId,
+      shareId: shareData.share.id,
+      userId: null,
+    });
+
    return {
      ...shareData,
      features: this.licenseCheckService.resolveFeatures(
@@ -0,0 +1,64 @@
+import { Kysely, sql } from 'kysely';
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .createTable('page_analytics')
+    .ifNotExists()
+    .addColumn('id', 'uuid', (col) =>
+      col.primaryKey().defaultTo(sql`gen_uuid_v7()`),
+    )
+    .addColumn('workspace_id', 'uuid', (col) =>
+      col.references('workspaces.id').onDelete('cascade').notNull(),
+    )
+    .addColumn('page_id', 'uuid', (col) =>
+      col.references('pages.id').onDelete('cascade').notNull(),
+    )
+    .addColumn('space_id', 'uuid', (col) =>
+      col.references('spaces.id').onDelete('cascade'),
+    )
+    .addColumn('user_id', 'uuid', (col) =>
+      col.references('users.id').onDelete('set null'),
+    )
+    .addColumn('share_id', 'uuid')
+    .addColumn('visitor_id', 'varchar', (col) => col.notNull())
+    .addColumn('view_date', 'varchar', (col) => col.notNull())
+    .addColumn('hits', 'int8', (col) => col.notNull().defaultTo(1))
+    .addColumn('last_viewed_at', 'timestamptz', (col) =>
+      col.notNull().defaultTo(sql`now()`),
+    )
+    .addColumn('created_at', 'timestamptz', (col) =>
+      col.notNull().defaultTo(sql`now()`),
+    )
+    .execute();
+
+  await db.schema
+    .createIndex('idx_page_analytics_workspace_page_date')
+    .ifNotExists()
+    .on('page_analytics')
+    .columns(['workspace_id', 'page_id', 'view_date'])
+    .execute();
+
+  await sql`
+    CREATE UNIQUE INDEX IF NOT EXISTS
+      uq_page_analytics_workspace_page_identity
+    ON page_analytics (
+      workspace_id,
+      page_id,
+      COALESCE(user_id::text, visitor_id)
+    )
+  `.execute(db);
+
+  await db.schema
+    .alterTable('workspaces')
+    .addColumn('page_analytics_retention_days', 'int8', (col) => col)
+    .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .alterTable('workspaces')
+    .dropColumn('page_analytics_retention_days')
+    .execute();
+
+  await db.schema.dropTable('page_analytics').ifExists().execute();
+}
@@ -437,6 +437,7 @@ export interface WorkspaceInvitations {
 }

 export interface Workspaces {
+  pageAnalyticsRetentionDays: Generated<number>;
  auditRetentionDays: Generated<number>;
  trashRetentionDays: Generated<number>;
  billingEmail: string | null;
@@ -544,6 +545,20 @@ export interface PagePermissions {
  updatedAt: Generated<Timestamp>;
 }

+export interface PageAnalytics {
+  id: Generated<string>;
+  workspaceId: string;
+  pageId: string;
+  spaceId: string | null;
+  shareId: string | null;
+  userId: string | null;
+  visitorId: string;
+  viewDate: string;
+  hits: Generated<number>;
+  lastViewedAt: Generated<Timestamp>;
+  createdAt: Generated<Timestamp>;
+}
+
 export interface PageVerifications {
  id: Generated<string>;
  pageId: string;
@@ -662,6 +677,7 @@ export interface DB {
  pagePermissions: PagePermissions;
  pageHistory: PageHistory;
  pageLabels: PageLabels;
+  pageAnalytics: PageAnalytics;
  pageVerifications: PageVerifications;
  pageVerifiers: PageVerifiers;
  pages: Pages;
@@ -1,6 +1,7 @@
 import { Insertable, Selectable, Updateable } from 'kysely';
 import {
  AiChats,
+  PageAnalytics as _PageAnalytics,
  AiChatMessages,
  Attachments,
  BaseProperties,
@@ -107,6 +108,10 @@ export type PageHistory = Selectable<History>;
 export type InsertablePageHistory = Insertable<History>;
 export type UpdatablePageHistory = Updateable<Omit<History, 'id'>>;

+export type PageAnalytics = Selectable<_PageAnalytics>;
+export type InsertablePageAnalytics = Insertable<_PageAnalytics>;
+export type UpdatablePageAnalytics = Updateable<Omit<_PageAnalytics, 'id'>>;
+
 // Comment
 export type Comment = Selectable<Comments>;
 export type InsertableComment = Insertable<Comments>;
@@ -0,0 +1,14 @@
+import { Global, Module } from '@nestjs/common';
+import { PAGE_ANALYTICS_SERVICE, NoopPageAnalyticsService } from './page-analytics.service';
+
+@Global()
+@Module({
+  providers: [
+    {
+      provide: PAGE_ANALYTICS_SERVICE,
+      useClass: NoopPageAnalyticsService,
+    },
+  ],
+  exports: [PAGE_ANALYTICS_SERVICE],
+})
+export class NoopPageAnalyticsModule {}
@@ -0,0 +1,21 @@
+import { Injectable } from '@nestjs/common';
+
+export type PageAnalyticsPayload = {
+  pageId: string;
+  workspaceId?: string;
+  spaceId?: string;
+  shareId?: string;
+  userId?: string | null;
+  visitorId?: string;
+};
+
+export const PAGE_ANALYTICS_SERVICE = Symbol('PAGE_ANALYTICS_SERVICE');
+
+export interface IPageAnalyticsService {
+  track(payload: PageAnalyticsPayload): void | Promise<void>;
+}
+
+@Injectable()
+export class NoopPageAnalyticsService implements IPageAnalyticsService {
+  track(_payload: PageAnalyticsPayload): void {}
+}
@@ -9,6 +9,7 @@ export enum QueueName {
  HISTORY_QUEUE = '{history-queue}',
  NOTIFICATION_QUEUE = '{notification-queue}',
  AUDIT_QUEUE = '{audit-queue}',
+  PAGE_ANALYTICS_QUEUE = '{page-analytics-queue}',
  BASE_QUEUE = '{base-queue}',
 }

@@ -81,6 +82,8 @@ export enum QueueJob {

  AUDIT_LOG = 'audit-log',
  AUDIT_CLEANUP = 'audit-cleanup',
+  PAGE_ANALYTICS_TRACK = 'page-analytics-track',
+  PAGE_ANALYTICS_CLEANUP = 'page-analytics-cleanup',

  PDF_EXPORT_TASK = 'pdf-export-task',
  PDF_EXPORT_CLEANUP = 'pdf-export-cleanup',
@@ -92,6 +92,14 @@ import { GeneralQueueProcessor } from './processors/general-queue.processor';
        attempts: 3,
      },
    }),
+    BullModule.registerQueue({
+      name: QueueName.PAGE_ANALYTICS_QUEUE,
+      defaultJobOptions: {
+        removeOnComplete: true,
+        removeOnFail: true,
+        attempts: 3,
+      },
+    }),
    BullModule.registerQueue({
      name: QueueName.BASE_QUEUE,
      defaultJobOptions: {
@@ -23,11 +23,11 @@
    "@casl/ability": "6.8.0",
    "@docmost/editor-ext": "workspace:*",
    "@floating-ui/dom": "1.7.3",
-    "@hocuspocus/common": "4.5.0",
-    "@hocuspocus/provider": "4.5.0",
-    "@hocuspocus/provider-react": "4.5.0",
-    "@hocuspocus/server": "4.5.0",
-    "@hocuspocus/transformer": "4.5.0",
+    "@hocuspocus/common": "4.4.0",
+    "@hocuspocus/provider": "4.4.0",
+    "@hocuspocus/provider-react": "4.4.0",
+    "@hocuspocus/server": "4.4.0",
+    "@hocuspocus/transformer": "4.4.0",
    "@joplin/turndown": "4.0.82",
    "@joplin/turndown-plugin-gfm": "1.0.64",
    "@sindresorhus/slugify": "3.0.0",
@@ -65,7 +65,7 @@
    "date-fns": "4.1.0",
    "diff": "8.0.3",
    "docx": "9.7.1",
-    "dompurify": "3.4.13",
+    "dompurify": "3.4.12",
    "fractional-indexing-jittered": "1.0.0",
    "highlight.js": "11.11.1",
    "image-dimensions": "2.5.0",
@@ -81,12 +81,12 @@
    "yjs": "^13.6.30"
  },
  "devDependencies": {
-    "@nx/js": "23.1.1",
+    "@nx/js": "22.7.2",
    "@types/bytes": "3.1.5",
    "@types/qrcode": "1.5.6",
    "@types/turndown": "5.0.6",
    "concurrently": "10.0.4",
-    "nx": "23.1.1",
+    "nx": "22.7.2",
    "tsx": "^4.21.0"
  },
  "workspaces": {
@@ -32,7 +32,6 @@ export * from "./lib/columns";
 export * from "./lib/status";
 export * from "./lib/pdf";
 export * from "./lib/page-break";
-export * from "./lib/footnotes";
 export * from "./lib/resizable-nodeview";
 export {
  pageNodeToDocxBuffer,
@@ -1,189 +0,0 @@
-//Source MIT - https://github.com/buttondown/tiptap-footnotes
-import { mergeAttributes } from "@tiptap/core";
-import ListItem, { ListItemOptions } from "@tiptap/extension-list-item";
-
-declare module "@tiptap/core" {
-  interface Commands<ReturnType> {
-    footnote: {
-      /**
-       * scrolls to & sets the text selection at the end of the footnote with the given id
-       * @param id the id of the footote (i.e. the `data-id` attribute value of the footnote)
-       * @example editor.commands.focusFootnote("a43956c1-1ab8-462f-96e4-be3a4b27fd50")
-       */
-      focusFootnote: (id: string) => ReturnType;
-    };
-  }
-}
-
-export interface FootnoteOptions extends ListItemOptions {
-  /**
-   * Content expression for this node
-   * @default "paragraph+"
-   */
-  content: string;
-}
-
-const Footnote = ListItem.extend<FootnoteOptions>({
-  name: "footnote",
-  content() {
-    return this.options.content;
-  },
-  isolating: true,
-  defining: true,
-  draggable: false,
-
-  addOptions() {
-    return {
-      HTMLAttributes: {},
-      bulletListTypeName: 'bulletList',
-      orderedListTypeName: 'orderedList',
-      ...this.parent?.(),
-      content: "paragraph+",
-    };
-  },
-
-  addAttributes() {
-    return {
-      id: {
-        isRequired: true,
-      },
-      // the data-id field should match the data-id field of a footnote reference.
-      // it's used to link footnotes and references together.
-      "data-id": {
-        isRequired: true,
-      },
-    };
-  },
-  parseHTML() {
-    return [
-      {
-        tag: "li",
-        getAttrs(node) {
-          const id = node.getAttribute("data-id");
-          if (id) {
-            return {
-              "data-id": node.getAttribute("data-id"),
-            };
-          }
-          return false;
-        },
-        priority: 1000,
-      },
-    ];
-  },
-  renderHTML({ HTMLAttributes }) {
-    return [
-      "li",
-      mergeAttributes(this.options.HTMLAttributes, HTMLAttributes),
-      0,
-    ];
-  },
-
-  addCommands() {
-    return {
-      focusFootnote:
-        (id: string) =>
-        ({ editor, chain }) => {
-          const matchedFootnote = editor.$node("footnote", {
-            "data-id": id,
-          });
-          if (matchedFootnote) {
-            // sets the text selection to the end of the footnote definition and scroll to it.
-            chain()
-              .focus()
-              .setTextSelection(
-                matchedFootnote.from + matchedFootnote.content.size
-              )
-              .run();
-
-            matchedFootnote.element.scrollIntoView();
-            return true;
-          }
-          return false;
-        },
-    };
-  },
-  addKeyboardShortcuts() {
-    return {
-      // when inside a footnote, Mod-a should select only the footnote content
-      "Mod-a": ({ editor }) => {
-        try {
-          const { selection } = editor.state;
-          const { $from } = selection;
-
-          for (let depth = $from.depth; depth >= 0; depth--) {
-            const node = $from.node(depth);
-            if (node.type.name === "footnote") {
-              const start = $from.start(depth);
-              const end = $from.end(depth);
-
-              editor.commands.setTextSelection({
-                from: start + 1,
-                to: end - 1,
-              });
-              return true;
-            }
-          }
-
-          return false;
-        } catch (e) {
-          return false;
-        }
-      },
-      // when the user presses tab, adjust the text selection to be at the end of the next footnote
-      Tab: ({ editor }) => {
-        try {
-          const { selection } = editor.state;
-          const pos = editor.$pos(selection.anchor);
-          if (!pos.after) return false;
-          // if the next node  is "footnotes", place the text selection at the end of the first footnote
-          if (pos.after.node.type.name == "footnotes") {
-            const firstChild = pos.after.node.child(0);
-            editor
-              .chain()
-              .setTextSelection(pos.after.from + firstChild.content.size)
-              .scrollIntoView()
-              .run();
-            return true;
-          } else {
-            const startPos = selection.$from.start(2);
-            if (Number.isNaN(startPos)) return false;
-            const parent = editor.$pos(startPos);
-            if (parent.node.type.name != "footnote" || !parent.after) {
-              return false;
-            }
-            // if the next node is a footnote, place the text selection at the end of it
-            editor
-              .chain()
-              .setTextSelection(parent.after.to - 1)
-              .scrollIntoView()
-              .run();
-            return true;
-          }
-        } catch {
-          return false;
-        }
-      },
-      // inverse of the tab command - place the text selection at the end of the previous footnote
-      "Shift-Tab": ({ editor }) => {
-        const { selection } = editor.state;
-        const startPos = selection.$from.start(2);
-        if (Number.isNaN(startPos)) return false;
-        const parent = editor.$pos(startPos);
-        if (parent.node.type.name != "footnote" || !parent.before) {
-          return false;
-        }
-
-        editor
-          .chain()
-          .setTextSelection(parent.before.to - 1)
-          .scrollIntoView()
-          .run();
-        return true;
-      },
-    };
-  },
-
-});
-
-export default Footnote;
@@ -1,46 +0,0 @@
-//Source MIT - https://github.com/buttondown/tiptap-footnotes
-import OrderedList from "@tiptap/extension-ordered-list";
-import FootnoteRules from "./rules";
-
-const Footnotes = OrderedList.extend({
-  name: "footnotes",
-  group: "", // removed the default group of the ordered list extension
-  isolating: true,
-  defining: true,
-  draggable: false,
-
-  content() {
-    return "footnote*";
-  },
-  addAttributes() {
-    return {
-      class: {
-        default: "footnotes",
-      },
-    };
-  },
-  parseHTML() {
-    return [
-      {
-        tag: "ol.footnotes",
-        priority: 1000,
-      },
-    ];
-  },
-
-  addKeyboardShortcuts() {
-    return {};
-  },
-  addCommands() {
-    return {};
-  },
-  addInputRules() {
-    return [];
-  },
-
-  addExtensions() {
-    return [FootnoteRules];
-  },
-});
-
-export default Footnotes;
@@ -1,4 +0,0 @@
-export { default as Footnotes } from "./footnotes";
-export { default as Footnote } from "./footnote";
-export type { FootnoteOptions } from "./footnote";
-export { default as FootnoteReference } from "./reference";
@@ -1,221 +0,0 @@
-//Source MIT - https://github.com/buttondown/tiptap-footnotes
-import { mergeAttributes, Node } from "@tiptap/core";
-import {
-  Fragment as PMFragment,
-  Node as PMNode,
-  Slice,
-} from "@tiptap/pm/model";
-import { NodeSelection, Plugin, PluginKey } from "@tiptap/pm/state";
-import { generateNodeId } from "../utils";
-
-
-const REFNUM_ATTR = "data-reference-number";
-const REF_CLASS = "footnote-ref";
-
-declare module "@tiptap/core" {
-  interface Commands<ReturnType> {
-    footnoteReference: {
-      /**
-       * add a new footnote reference
-       * @example editor.commands.addFootnote()
-       */
-      addFootnote: () => ReturnType;
-    };
-  }
-}
-
-const FootnoteReference = Node.create({
-  name: "footnoteReference",
-  inline: true,
-  content: "text*",
-  group: "inline",
-  atom: true,
-  draggable: true,
-
-  parseHTML() {
-    return [
-      {
-        tag: `sup`,
-        priority: 1000,
-        getAttrs(node) {
-          const anchor = node.querySelector<HTMLAnchorElement>(
-            `a.${REF_CLASS}:first-child`
-          );
-
-          if (!anchor) {
-            return false;
-          }
-
-          const id = anchor.getAttribute("data-id");
-          const ref = anchor.getAttribute(REFNUM_ATTR);
-
-          return {
-            "data-id": id ?? generateNodeId(),
-            referenceNumber: ref ?? anchor.innerText,
-          };
-        },
-        contentElement(node) {
-          return node.firstChild as HTMLElement;
-        },
-      },
-    ];
-  },
-
-  addAttributes() {
-    return {
-      class: {
-        default: REF_CLASS,
-      },
-      "data-id": {
-        renderHTML(attributes) {
-          return {
-            "data-id": attributes["data-id"] || generateNodeId(),
-          };
-        },
-      },
-      referenceNumber: {},
-
-      href: {
-        renderHTML(attributes) {
-          return {
-            href: `#fn:${attributes["referenceNumber"]}`,
-          };
-        },
-      },
-    };
-  },
-
-  renderHTML({ HTMLAttributes }) {
-    const { referenceNumber, ...attributes } = HTMLAttributes;
-    const attrs = mergeAttributes(this.options.HTMLAttributes, attributes);
-    attrs[REFNUM_ATTR] = referenceNumber;
-
-    return [
-      "sup",
-      { id: `fnref:${referenceNumber}` },
-      ["a", attrs, HTMLAttributes.referenceNumber],
-    ];
-  },
-
-  addProseMirrorPlugins() {
-    const { editor } = this;
-
-    // Ensures pasted footnote references get unique IDs.
-    const mapNode = (node: PMNode): PMNode => {
-      if (node.type.name === this.name) {
-        const newAttrs = { ...node.attrs, "data-id": generateNodeId() };
-        return node.type.create(newAttrs, node.content, node.marks);
-      }
-
-      if (node.content && node.content.size > 0) {
-        const newChildren: PMNode[] = [];
-        let changed = false;
-
-        node.content.forEach((child) => {
-          const mapped = mapNode(child);
-          if (mapped !== child) {
-            changed = true;
-          }
-
-          newChildren.push(mapped);
-        });
-
-        if (changed) {
-          return node.copy(PMFragment.from(newChildren));
-        }
-      }
-
-      return node;
-    };
-
-    return [
-      new Plugin({
-        key: new PluginKey("footnotePasteHandler"),
-        props: {
-          transformPasted(slice) {
-            const mappedNodes: PMNode[] = [];
-            let changed = false;
-
-            slice.content.forEach((node) => {
-              const mapped = mapNode(node);
-              if (mapped !== node) {
-                changed = true;
-              }
-              mappedNodes.push(mapped);
-            });
-
-            if (!changed) {
-              return slice;
-            }
-
-            return new Slice(
-              PMFragment.from(mappedNodes),
-              slice.openStart,
-              slice.openEnd
-            );
-          },
-        },
-      }),
-      new Plugin({
-        key: new PluginKey("footnoteRefClick"),
-
-        props: {
-          // on double-click, focus on the footnote
-          handleDoubleClickOn(view, pos, node, nodePos, event) {
-            if (node.type.name != "footnoteReference") return false;
-            event.preventDefault();
-            const id = node.attrs["data-id"];
-            return editor.commands.focusFootnote(id);
-          },
-          // click the footnote reference once to get focus, click twice to scroll to the footnote
-          handleClickOn(view, pos, node, nodePos, event) {
-            if (node.type.name != "footnoteReference") return false;
-            event.preventDefault();
-            const { selection } = editor.state.tr;
-            if (selection instanceof NodeSelection && selection.node.eq(node)) {
-              const id = node.attrs["data-id"];
-              return editor.commands.focusFootnote(id);
-            } else {
-              editor.chain().setNodeSelection(nodePos).run();
-              return true;
-            }
-          },
-        },
-      }),
-    ];
-  },
-
-  addCommands() {
-    return {
-      addFootnote:
-        () =>
-        ({ state, tr }) => {
-          const node = this.type.create({
-            "data-id": generateNodeId(),
-          });
-          tr.insert(state.selection.anchor, node);
-          return true;
-        },
-    };
-  },
-
-  addInputRules() {
-    // when a user types [^text], add a new footnote
-    return [
-      {
-        find: /\[\^(.*?)\]/,
-        type: this.type,
-        undoable: true,
-        handler({ range, match, chain }) {
-          const start = range.from;
-          let end = range.to;
-          if (match[1]) {
-            chain().deleteRange({ from: start, to: end }).addFootnote().run();
-          }
-        },
-      },
-    ];
-  },
-});
-
-export default FootnoteReference;
@@ -1,90 +0,0 @@
-//Source MIT - https://github.com/buttondown/tiptap-footnotes
-import { Plugin, PluginKey } from "@tiptap/pm/state";
-import { ReplaceStep } from "@tiptap/pm/transform";
-import { Extension } from "@tiptap/core";
-import { updateFootnotesList } from "./utils";
-
-const FootnoteRules = Extension.create({
-  name: "footnoteRules",
-  priority: 1000,
-  addProseMirrorPlugins() {
-    return [
-      new Plugin({
-        key: new PluginKey("footnoteRules"),
-        filterTransaction(tr) {
-          const { from, to } = tr.selection;
-
-          // Allow full document selections (Mod-a/Ctrl-a)
-          if (from === 0 && to === tr.doc.content.size) return true;
-
-          let selectedFootnotes = false;
-          let selectedContent = false;
-          let footnoteCount = 0;
-          tr.doc.nodesBetween(from, to, (node, _, parent) => {
-            if (parent?.type.name == "doc" && node.type.name != "footnotes") {
-              selectedContent = true;
-            } else if (node.type.name == "footnote") {
-              footnoteCount += 1;
-            } else if (node.type.name == "footnotes") {
-              selectedFootnotes = true;
-            }
-          });
-          const overSelected = selectedContent && selectedFootnotes;
-          /*
-           * Here, we don't allow any transaction that spans between the "content" nodes and the "footnotes" node. This also rejects any transaction that spans between more than 1 footnote.
-           */
-          return !overSelected && footnoteCount <= 1;
-        },
-
-        // if there are some to the footnote references (added/deleted/dragged), append a transaction that updates the footnotes list accordingly
-        appendTransaction(transactions, oldState, newState) {
-          let newTr = newState.tr;
-          let refsChanged = false; // true if the footnote references have been changed, false otherwise
-          for (let tr of transactions) {
-            if (!tr.docChanged) continue;
-            if (refsChanged) break;
-
-            for (let step of tr.steps) {
-              if (!(step instanceof ReplaceStep)) continue;
-              if (refsChanged) break;
-
-              const isDelete = step.from != step.to; // the user deleted items from the document (from != to & the step is a replace step)
-              const isInsert = step.slice.size > 0;
-
-              // check if any footnote references have been inserted
-              if (isInsert) {
-                step.slice.content.descendants((node) => {
-                  if (node?.type.name == "footnoteReference") {
-                    refsChanged = true;
-                    return false;
-                  }
-                });
-              }
-              if (isDelete && !refsChanged) {
-                // check if any footnote references have been deleted
-                tr.before.nodesBetween(
-                  step.from,
-                  Math.min(tr.before.content.size, step.to), // make sure to not go over the old document's limit
-                  (node) => {
-                    if (node.type.name == "footnoteReference") {
-                      refsChanged = true;
-                      return false;
-                    }
-                  },
-                );
-              }
-            }
-          }
-
-          if (refsChanged) {
-            updateFootnotesList(newTr, newState);
-            return newTr;
-          }
-
-          return null;
-        },
-      }),
-    ];
-  },
-});
-export default FootnoteRules;
@@ -1,123 +0,0 @@
-//Source MIT - https://github.com/buttondown/tiptap-footnotes
-import { EditorState, Transaction } from "@tiptap/pm/state";
-import { Fragment, Node } from "@tiptap/pm/model";
-
-// update the reference number of all the footnote references in the document
-export function updateFootnoteReferences(tr: Transaction) {
-  let count = 1;
-
-  const nodes: any[] = [];
-
-  tr.doc.descendants((node, pos) => {
-    if (node.type.name == "footnoteReference") {
-      tr.setNodeAttribute(pos, "referenceNumber", `${count}`);
-
-      nodes.push(node);
-      count += 1;
-    }
-  });
-  // return the updated footnote references (in the order that they appear in the document)
-  return nodes;
-}
-
-function getFootnotes(tr: Transaction) {
-  let footnotesRange: { from: number; to: number } | undefined;
-  const footnotes: Node[] = [];
-  tr.doc.descendants((node, pos) => {
-    if (node.type.name == "footnote") {
-      footnotes.push(node);
-    } else if (node.type.name == "footnotes") {
-      footnotesRange = { from: pos, to: pos + node.nodeSize };
-    } else {
-      return false;
-    }
-  });
-  return { footnotesRange, footnotes };
-}
-
-// update the "footnotes" ordered list based on the footnote references in the document
-export function updateFootnotesList(tr: Transaction, state: EditorState) {
-  const footnoteReferences = updateFootnoteReferences(tr);
-
-  const footnoteType = state.schema.nodes.footnote;
-  const footnotesType = state.schema.nodes.footnotes;
-
-  const emptyParagraph = state.schema.nodeFromJSON({
-    type: "paragraph",
-    content: [],
-  });
-
-  const { footnotesRange, footnotes } = getFootnotes(tr);
-
-  // a mapping of footnote id -> footnote node
-  const footnoteIds: { [key: string]: Node } = footnotes.reduce(
-    (obj, footnote) => {
-      obj[footnote.attrs["data-id"]] = footnote;
-      return obj;
-    },
-    {} as any,
-  );
-
-  const newFootnotes: Node[] = [];
-
-  let footnoteRefIds = new Set(
-    footnoteReferences.map((ref) => ref.attrs["data-id"]),
-  );
-  const deleteFootnoteIds: Set<string> = new Set();
-  for (let footnote of footnotes) {
-    const id = footnote.attrs["data-id"];
-    if (!footnoteRefIds.has(id) || deleteFootnoteIds.has(id)) {
-      deleteFootnoteIds.add(id);
-      // we traverse through this footnote's content because it may contain footnote references.
-      // we want to delete the footnotes associated with these references, so we add them to the delete set.
-      footnote.content.descendants((node) => {
-        if (node.type.name == "footnoteReference")
-          deleteFootnoteIds.add(node.attrs["data-id"]);
-      });
-    }
-  }
-
-  for (let i = 0; i < footnoteReferences.length; i++) {
-    let refId = footnoteReferences[i].attrs["data-id"];
-
-    if (deleteFootnoteIds.has(refId)) continue;
-    // if there is a footnote w/ the same id as this `ref`, we preserve its content and update its id attribute
-    if (refId in footnoteIds) {
-      let footnote = footnoteIds[refId];
-      newFootnotes.push(
-        footnoteType.create(
-          { ...footnote.attrs, id: `fn:${i + 1}` },
-          footnote.content,
-        ),
-      );
-    } else {
-      let newNode = footnoteType.create(
-        {
-          "data-id": refId,
-          id: `fn:${i + 1}`,
-        },
-        [emptyParagraph],
-      );
-      newFootnotes.push(newNode);
-    }
-  }
-
-  if (newFootnotes.length == 0) {
-    // no footnotes in the doc, delete the "footnotes" node
-    if (footnotesRange) {
-      tr.delete(footnotesRange.from, footnotesRange.to);
-    }
-  } else if (!footnotesRange) {
-    // there is no footnotes node present in the doc, add it
-    tr.insert(
-      tr.doc.content.size,
-      footnotesType.create(undefined, Fragment.from(newFootnotes)),
-    );
-  } else {
-    tr.replaceWith(
-      footnotesRange!.from + 1, // add 1 to point at the position after the opening ol tag
-      footnotesRange!.to - 1, // substract 1 to point to the position before the closing ol tag
-      Fragment.from(newFootnotes),
-    );
-  }
-}
@@ -1,110 +0,0 @@
-import { Token, marked } from 'marked';
-import { generateNodeId } from '../../utils';
-
-interface FootnoteRefToken {
-  type: 'footnoteRef';
-  label: string;
-  raw: string;
-}
-
-interface FootnoteDefToken {
-  type: 'footnoteDef';
-  label: string;
-  text: string;
-  raw: string;
-}
-
-// Parse-scoped state: markdownToHtml resets before the top-level parse and
-// appends the collected list after it. Nested marked.parse calls (callout,
-// footnote definitions) share this state, so hooks cannot be used here.
-let footnoteRefs: { label: string; id: string; number: number }[] = [];
-let footnoteDefs = new Map<string, string>();
-
-export function resetFootnotes() {
-  footnoteRefs = [];
-  footnoteDefs = new Map();
-}
-
-export function renderFootnotesList(): string {
-  if (!footnoteRefs.length) return '';
-  const items = footnoteRefs.map(({ label, id, number }) => {
-    const body = footnoteDefs.get(label) || '<p></p>';
-    return `<li id="fn:${number}" data-id="${id}">${body}</li>`;
-  });
-  return `<ol class="footnotes">\n${items.join('\n')}\n</ol>\n`;
-}
-
-export const footnoteRefExtension = {
-  name: 'footnoteRef',
-  level: 'inline',
-  start(src: string) {
-    return src.indexOf('[^');
-  },
-  tokenizer(src: string): FootnoteRefToken | undefined {
-    const match = /^\[\^([^\]\s]+)\]/.exec(src);
-    if (match) {
-      return {
-        type: 'footnoteRef',
-        raw: match[0],
-        label: match[1].toLowerCase(),
-      };
-    }
-  },
-  renderer(token: Token) {
-    const refToken = token as FootnoteRefToken;
-    const number = footnoteRefs.length + 1;
-    const id = generateNodeId();
-    footnoteRefs.push({ label: refToken.label, id, number });
-    return `<sup id="fnref:${number}"><a class="footnote-ref" data-id="${id}" data-reference-number="${number}" href="#fn:${number}">${number}</a></sup>`;
-  },
-};
-
-export const footnoteDefExtension = {
-  name: 'footnoteDef',
-  level: 'block',
-  start(src: string) {
-    return src.match(/^\[\^[^\]\s]+\]:/m)?.index ?? -1;
-  },
-  tokenizer(src: string): FootnoteDefToken | undefined {
-    const firstLine = /^\[\^([^\]\s]+)\]:[ \t]*/.exec(src);
-    if (!firstLine) return undefined;
-
-    const lines = src.split('\n');
-    const contentLines = [lines[0].slice(firstLine[0].length)];
-    let consumed = 1;
-    while (consumed < lines.length) {
-      const line = lines[consumed];
-      if (/^[ \t]{2,}\S/.test(line)) {
-        contentLines.push(line.replace(/^[ \t]{1,4}/, ''));
-        consumed += 1;
-      } else if (
-        /^[ \t]*$/.test(line) &&
-        consumed + 1 < lines.length &&
-        /^[ \t]{2,}\S/.test(lines[consumed + 1])
-      ) {
-        contentLines.push('');
-        consumed += 1;
-      } else {
-        break;
-      }
-    }
-
-    const raw =
-      lines.slice(0, consumed).join('\n') +
-      (consumed < lines.length ? '\n' : '');
-    return {
-      type: 'footnoteDef',
-      raw,
-      label: firstLine[1].toLowerCase(),
-      text: contentLines.join('\n').trim(),
-    };
-  },
-  renderer(token: Token) {
-    const defToken = token as FootnoteDefToken;
-    const body = defToken.text
-      ? marked.parse(defToken.text).toString()
-      : '<p></p>';
-    footnoteDefs.set(defToken.label, body);
-    return '';
-  },
-};
@@ -2,12 +2,6 @@ import { marked } from "marked";
 import { calloutExtension } from "./callout.marked";
 import { mathBlockExtension } from "./math-block.marked";
 import { mathInlineExtension } from "./math-inline.marked";
-import {
-  footnoteDefExtension,
-  footnoteRefExtension,
-  renderFootnotesList,
-  resetFootnotes,
-} from "./footnotes.marked";

 marked.use({
  renderer: {
@@ -40,13 +34,7 @@ marked.use({
 });

 marked.use({
-  extensions: [
-    calloutExtension,
-    mathBlockExtension,
-    mathInlineExtension,
-    footnoteDefExtension,
-    footnoteRefExtension,
-  ],
+  extensions: [calloutExtension, mathBlockExtension, mathInlineExtension],
 });

 marked.setOptions({ breaks: true });
@@ -60,7 +48,5 @@ export function markdownToHtml(
    .replace(YAML_FONT_MATTER_REGEX, "")
    .trimStart();

-  resetFootnotes();
-  const html = marked.parse(markdown).toString();
-  return html + renderFootnotesList();
+  return marked.parse(markdown).toString();
 }
@@ -34,8 +34,6 @@ export function htmlToMarkdown(html: string): string {
    iframeEmbed,
    image,
    video,
-    footnoteRef,
-    footnotesList,
  ]);
  return turndownService.turndown(html).replaceAll('<br>', ' ');
 }
@@ -205,56 +203,6 @@ function image(turndownService: _TurndownService) {
  });
 }

-function getFootnoteAnchor(node: HTMLElement): HTMLElement | null {
-  const child = node.firstElementChild as HTMLElement | null;
-  return child?.nodeName === 'A' && child.classList.contains('footnote-ref')
-    ? child
-    : null;
-}
-
-function footnoteRef(turndownService: _TurndownService) {
-  turndownService.addRule('footnoteRef', {
-    filter: function (node: HTMLInputElement) {
-      return node.nodeName === 'SUP' && !!getFootnoteAnchor(node);
-    },
-    replacement: function (_content: string, node: HTMLInputElement) {
-      const anchor = getFootnoteAnchor(node);
-      const number =
-        anchor.getAttribute('data-reference-number') || anchor.textContent;
-      return `[^${number}]`;
-    },
-  });
-}
-
-function footnotesList(turndownService: _TurndownService) {
-  turndownService.addRule('footnotesList', {
-    filter: function (node: HTMLInputElement) {
-      return node.nodeName === 'OL' && node.classList.contains('footnotes');
-    },
-    replacement: function (_content: string, node: HTMLInputElement) {
-      const items = Array.from(node.children).filter(
-        (child) => child.nodeName === 'LI',
-      );
-      const definitions = items.map((li, index) => {
-        const number =
-          (li.getAttribute('id') || '').replace('fn:', '') ||
-          String(index + 1);
-        const markdown = turndownService
-          .turndown((li as HTMLElement).innerHTML)
-          .trim();
-        // continuation lines need a 4-space indent to stay in the footnote
-        const [first, ...rest] = markdown.split('\n');
-        const body = [
-          first,
-          ...rest.map((line: string) => (line.trim() ? `    ${line}` : line)),
-        ].join('\n');
-        return `[^${number}]: ${body}`;
-      });
-      return `\n\n${definitions.join('\n')}\n\n`;
-    },
-  });
-}
-
 function video(turndownService: _TurndownService) {
  turndownService.addRule('video', {
    filter: function (node: HTMLInputElement) {
@@ -1,4 +1,4 @@
-import { FootnoteReferenceRun, HeadingLevel, Paragraph, ShadingType } from 'docx';
+import { HeadingLevel, ShadingType } from 'docx';
 import { Node } from 'prosemirror-model';
 import {
  DocxSerializerAsync,
@@ -168,27 +168,6 @@ export const defaultAsyncNodes: NodeSerializerAsync = {
  pageBreak(state, node) {
    state.closeBlock(node, { pageBreakBefore: true });
  },
-  footnoteReference(state, node) {
-    const number =
-      Number(node.attrs?.referenceNumber) || state.$footnoteCounter + 1;
-    state.$footnoteCounter = Math.max(state.$footnoteCounter, number);
-    // seed an empty body so the reference stays valid even if the trailing
-    // footnotes list is missing; the footnotes node overwrites it with content
-    if (!state.footnotes[number]) {
-      state.footnotes[number] = { children: [new Paragraph('')] };
-    }
-    state.current.push(new FootnoteReferenceRun(number));
-  },
-  async footnotes(state, node) {
-    for (let i = 0; i < node.childCount; i += 1) {
-      const item = node.child(i);
-      const number =
-        Number(String(item.attrs?.id ?? '').replace('fn:', '')) || i + 1;
-      await state.footnoteDefinition(item, number);
-    }
-  },
-  // items are consumed by the footnotes handler above
-  footnote() {},
  // No usable static export representation: skip without failing.
  subpages() {},
  transclusionReference() {},
@@ -824,29 +824,6 @@ export class DocxSerializerStateAsync {
    this.current.push(new FootnoteReferenceRun(this.$footnoteCounter));
  }

-  // Fills the footnote body for an already-referenced footnote number from a
-  // node holding block content (Docmost keeps footnote text in a trailing
-  // list, separate from the inline reference).
-  async footnoteDefinition(node: Node, number: number) {
-    const { current, children, nextRunOpts, nextParentParagraphOpts } = this;
-    this.current = [];
-    this.children = [];
-    delete this.nextRunOpts;
-    delete this.nextParentParagraphOpts;
-
-    await this.renderContent(node);
-    this.footnotes[number] = {
-      children: this.children.filter(
-        (child): child is Paragraph => child instanceof Paragraph,
-      ),
-    };
-
-    this.current = current;
-    this.children = children;
-    this.nextRunOpts = nextRunOpts;
-    this.nextParentParagraphOpts = nextParentParagraphOpts;
-  }
-
  closeBlock(node: Node, props?: IParagraphOptions) {
    const paragraph = new Paragraph({
      children: this.current,
@@ -7,19 +7,9 @@ export interface TrailingNodeExtensionOptions {
 }

 function nodeEqualsType({ types, node }: { types: any, node: any }) {
-  if (!node) return false
  return (Array.isArray(types) && types.includes(node.type)) || node.type === types
 }

-// footnotes must stay the last doc child, so the trailing node goes before it
-function lastNodeBeforeFootnotes(doc: any) {
-  const lastChild = doc.lastChild
-  if (lastChild?.type.name === 'footnotes') {
-    return doc.childCount > 1 ? doc.child(doc.childCount - 2) : null
-  }
-  return lastChild
-}
-
 // @ts-ignore
 /**
 * Extension based on:
@@ -50,23 +40,19 @@ export const TrailingNode = Extension.create<TrailingNodeExtensionOptions>({
        appendTransaction: (_, __, state) => {
          const { doc, tr, schema } = state;
          const shouldInsertNodeAtEnd = plugin.getState(state);
+          const endPosition = doc.content.size;
          const type = schema.nodes[this.options.node]

          if (!shouldInsertNodeAtEnd) {
            return;
          }

-          const lastChild = doc.lastChild
-          const endPosition = lastChild?.type.name === 'footnotes'
-            ? doc.content.size - lastChild.nodeSize
-            : doc.content.size
-
          return tr.insert(endPosition, type.create());
        },
        state: {
          init: (_, state) => {
            try {
-              const lastNode = lastNodeBeforeFootnotes(state.tr.doc)
+              const lastNode = state.tr.doc.lastChild
              return !nodeEqualsType({ node: lastNode, types: disabledNodes })
            } catch (err){
              console.log(err)
@@ -84,7 +70,7 @@ export const TrailingNode = Extension.create<TrailingNodeExtensionOptions>({
              return value
            }

-            const lastNode = lastNodeBeforeFootnotes(tr.doc)
+            const lastNode = tr.doc.lastChild
            return !nodeEqualsType({ node: lastNode, types: disabledNodes })
          },
        },
@@ -7,11 +7,11 @@ overrides:
  prosemirror-changeset: 2.4.0
  glob: 13.0.6
  ws: 8.21.0
-  dompurify: 3.4.13
-  mermaid: 11.16.1
+  dompurify: 3.4.12
+  mermaid: 11.15.0
  undici: 7.29.0
  tmp: 0.2.7
-  nanoid@^3: 3.3.17
+  nanoid@^3: 3.3.8
  lodash-es: 4.18.1
  express-rate-limit: 8.2.2
  flatted: 3.4.2
@@ -22,11 +22,9 @@ overrides:
  ip-address: 10.3.1
  fast-uri: 3.1.5
  form-data@>=4.0.0 <4.0.6: 4.0.6
-  nanoid@>=4.0.0 <5.1.16: 5.1.16
+  nanoid@>=4.0.0 <5.0.9: 5.1.16
  esbuild@>=0.27.3 <0.28.1: 0.28.1
  '@opentelemetry/core@>=2.0.0 <2.8.0': 2.9.0
-  js-yaml@>=3.0.0 <3.15.1: 3.15.1
-  js-yaml@>=4.0.0 <4.3.1: 4.3.1
 shamefullyHoist: true
 minimumReleaseAge: 4320
 allowBuilds:
Author	SHA1	Message	Date
Salihu	739da05d07	clickhouse store	2026-08-20 00:07:50 +01:00
Salihu	4a412899e8	scheduled cleanup	2026-08-14 23:14:02 +01:00
Salihu	fd81cd281f	page analytics retention	2026-08-14 23:12:36 +01:00
Salihu	e204184ad8	fix naming conflicts	2026-08-14 16:20:18 +01:00
Salihu	19e2e8ba1c	fix naming conflicts	2026-08-14 16:19:12 +01:00
Salihu	79bf2c3cd7	fix issues	2026-08-13 23:43:09 +01:00
Salihu	76ca723d90	chore: update EE submodule	2026-08-13 22:32:21 +01:00
Salihu	734f59967e	page analytics init	2026-08-13 22:25:08 +01:00