Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Show file names under titles in the folder view (PRD-10217) (#8076)

Dimitri POSTOLOV1fd12768e39d
diff --git a/.changeset/folder-overview-file-names.md b/.changeset/folder-overview-file-names.md
new file mode 100644
index 000000000..9ae0c50b6
--- /dev/null
+++ b/.changeset/folder-overview-file-names.md
@@ -0,0 +1,5 @@
+---
+"@inkeep/open-knowledge": patch
+---
+
+The folder view now shows a file's name under its title when the two differ, so each row matches the file tree.
diff --git a/packages/app/src/components/FolderOverview.tsx b/packages/app/src/components/FolderOverview.tsx
index 7e790072f..ee8aff8ce 100644
--- a/packages/app/src/components/FolderOverview.tsx
+++ b/packages/app/src/components/FolderOverview.tsx
@@ -241,7 +241,14 @@ export function FolderOverview({ folderPath }: { folderPath: string }) {
) : (
<File className="size-4 shrink-0 text-muted-foreground" />
)}
- <span className="truncate">{entry.title}</span>
+ <span className="flex min-w-0 flex-col">
+ <span className="truncate">{entry.title}</span>
+ {entry.fileName && (
+ <span className="truncate text-xs text-muted-foreground">
+ {entry.fileName}
+ </span>
+ )}
+ </span>
</a>
</TableCell>
<TableCell className="text-muted-foreground">
diff --git a/packages/app/src/components/folder-overview-data.test.ts b/packages/app/src/components/folder-overview-data.test.ts
index bebecc7e6..38dfdeba4 100644
--- a/packages/app/src/components/folder-overview-data.test.ts
+++ b/packages/app/src/components/folder-overview-data.test.ts
@@ -30,12 +30,13 @@ describe('buildFolderOverviewData', () => {
expect(data.children).toEqual([
{ kind: 'folder', path: 'reports/q2', name: 'q2', title: 'q2' },
- { kind: 'folder', path: 'reports/q1', name: 'q1', title: 'Quarter One' },
+ { kind: 'folder', path: 'reports/q1', name: 'q1', title: 'Quarter One', fileName: 'q1' },
{
kind: 'file',
path: 'reports/monthly',
name: 'monthly',
title: 'Monthly Review',
+ fileName: 'monthly.md',
size: 150,
modified: '2026-04-11T00:00:00Z',
},
@@ -44,6 +45,7 @@ describe('buildFolderOverviewData', () => {
path: 'reports/index',
name: 'index',
title: 'Reports',
+ fileName: 'index.md',
size: 100,
modified: '2026-04-10T00:00:00Z',
},
@@ -52,6 +54,7 @@ describe('buildFolderOverviewData', () => {
path: 'reports/weekly',
name: 'weekly',
title: 'Weekly Review',
+ fileName: 'weekly.md',
size: 200,
modified: '2026-04-12T00:00:00Z',
},
@@ -69,6 +72,29 @@ describe('buildFolderOverviewData', () => {
expect(data.children[0]).toMatchObject({ kind: 'file', title: 'readme' });
});
+ test('file name takes the extension the listing reports', () => {
+ const data = buildFolderOverviewData('docs', {
+ pages: new Set(['docs/guide']),
+ pageTitles: new Map([['docs/guide', 'Getting started']]),
+ pageMeta: new Map([['docs/guide', { size: 1, modified: '', docExt: '.mdx' }]]),
+ folderPaths: new Set(),
+ });
+
+ expect(data.children[0]).toMatchObject({ title: 'Getting started', fileName: 'guide.mdx' });
+ });
+
+ test('no file name when the title already is the full file name', () => {
+ const data = buildFolderOverviewData('docs', {
+ pages: new Set(['docs/notes']),
+ pageTitles: new Map([['docs/notes', 'Notes.md']]),
+ pageMeta: new Map(),
+ folderPaths: new Set(),
+ });
+
+ expect(data.children[0]).toMatchObject({ title: 'Notes.md' });
+ expect(data.children[0]?.fileName).toBeUndefined();
+ });
+
test('content-root (empty folderPath) lists only top-level children', () => {
const data = buildFolderOverviewData('', {
pages: new Set(['intro', 'README', 'docs/a', 'docs/b', 'reports/q1/summary']),
diff --git a/packages/app/src/components/folder-overview-data.ts b/packages/app/src/components/folder-overview-data.ts
index d2e738b58..3813eb773 100644
--- a/packages/app/src/components/folder-overview-data.ts
+++ b/packages/app/src/components/folder-overview-data.ts
@@ -1,8 +1,17 @@
+import { docNameToTreePath } from './file-tree-adapter';
import type { PageMeta } from './PageListContext';
export type FolderOverviewEntry =
- | { kind: 'folder'; path: string; name: string; title: string }
- | { kind: 'file'; path: string; name: string; title: string; size: number; modified: string };
+ | { kind: 'folder'; path: string; name: string; title: string; fileName?: string }
+ | {
+ kind: 'file';
+ path: string;
+ name: string;
+ title: string;
+ fileName?: string;
+ size: number;
+ modified: string;
+ };
interface FolderOverviewData {
title: string;
@@ -41,6 +50,18 @@ function resolveTitle(
return leafName;
}
+function fileNameUnlessTitleShowsIt(
+ title: string,
+ fileName: string,
+ stem = fileName,
+): string | undefined {
+ const label = title.toLocaleLowerCase();
+ if (label === stem.toLocaleLowerCase() || label === fileName.toLocaleLowerCase()) {
+ return undefined;
+ }
+ return fileName;
+}
+
export function buildFolderOverviewData(
folderPath: string,
options: {
@@ -56,12 +77,16 @@ export function buildFolderOverviewData(
.filter((path) => path.startsWith(prefix))
.map((path) => ({ path, rel: path.slice(prefix.length) }))
.filter((e) => e.rel.length > 0 && !e.rel.includes('/'))
- .map(({ path, rel }) => ({
- kind: 'folder' as const,
- path,
- name: rel,
- title: getFolderTitle(path, options.pageTitles),
- }));
+ .map(({ path, rel }) => {
+ const title = getFolderTitle(path, options.pageTitles);
+ return {
+ kind: 'folder' as const,
+ path,
+ name: rel,
+ title,
+ fileName: fileNameUnlessTitleShowsIt(title, rel),
+ };
+ });
const files: FolderOverviewEntry[] = [...options.pages]
.filter((docName) => docName.startsWith(prefix))
@@ -69,11 +94,14 @@ export function buildFolderOverviewData(
.filter((e) => e.rel.length > 0 && !e.rel.includes('/'))
.map(({ docName, rel }) => {
const meta = options.pageMeta.get(docName);
+ const title = resolveTitle(docName, rel, options.pageTitles);
+ const fileName = docNameToTreePath(rel, meta?.docExt);
return {
kind: 'file' as const,
path: docName,
name: rel,
- title: resolveTitle(docName, rel, options.pageTitles),
+ title,
+ fileName: fileNameUnlessTitleShowsIt(title, fileName, rel),
size: meta?.size ?? 0,
modified: meta?.modified ?? '',
};
diff --git a/packages/app/tests/stress/folder-overview-file-names.e2e.ts b/packages/app/tests/stress/folder-overview-file-names.e2e.ts
new file mode 100644
index 000000000..dbec37a43
--- /dev/null
+++ b/packages/app/tests/stress/folder-overview-file-names.e2e.ts
@@ -0,0 +1,33 @@
+import { expect, test } from './_helpers';
+
+test.describe('folder overview file names', () => {
+ test('each row shows its title, with the file name under a title that differs from it', async ({
+ page,
+ api,
+ }) => {
+ await api.seedDocs([
+ { name: 'overview-names/burndown', markdown: '# Burndown\n\nRemaining work.\n' },
+ {
+ name: 'overview-names/do-performance',
+ markdown: '---\ntitle: DO performance & capacity\n---\n\nLoad numbers.\n',
+ },
+ {
+ name: 'overview-names/plain-notes',
+ markdown: 'Notes with no frontmatter and no heading.\n',
+ },
+ { name: 'overview-names/ui-tracker', markdown: '# OK Cloud features\n\nWhat to build.\n' },
+ ]);
+
+ await page.goto('/#/overview-names/');
+
+ await expect(page.getByRole('table').getByRole('link')).toHaveText(
+ [
+ 'Burndown',
+ 'DO performance & capacity\ndo-performance.md',
+ 'OK Cloud features\nui-tracker.md',
+ 'plain-notes',
+ ],
+ { useInnerText: true, timeout: 20_000 },
+ );
+ });
+});