Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

PRD-7967 Present frontmatter schemas as stable (#3455)

serafin-garcia23a0f69292d6
diff --git a/.changeset/frontmatter-schemas-stable.md b/.changeset/frontmatter-schemas-stable.md
new file mode 100644
index 000000000..e41198cb6
--- /dev/null
+++ b/.changeset/frontmatter-schemas-stable.md
@@ -0,0 +1,5 @@
+---
+"@inkeep/open-knowledge": patch
+---
+
+Frontmatter schemas are now presented as a stable feature throughout the app and documentation.
diff --git a/docs/content/plugins/overview.mdx b/docs/content/plugins/overview.mdx
index 107bbd4aa..2dbb94702 100644
--- a/docs/content/plugins/overview.mdx
+++ b/docs/content/plugins/overview.mdx
@@ -25,7 +25,7 @@ Flip the switch. Open editors react live; there is no restart and no Save button
| Plugin | Scope | What it does |
| --- | --- | --- |
| [markdownlint](/docs/advanced/content-rules/markdownlint) | Project | Flags markdown style problems as you write — hard tabs, heading increments, list markers, and the rest of the standard rule set. |
-| [Frontmatter schemas](/docs/advanced/content-rules/frontmatter) | Project | Validates document frontmatter against standard JSON Schema files. Beta. |
+| [Frontmatter schemas](/docs/advanced/content-rules/frontmatter) | Project | Validates document frontmatter against standard JSON Schema files. |
| [Slidev](/docs/plugins/slidev) | User | Presents a document as a slide deck in its own window. Desktop only; needs the Slidev CLI installed separately. Beta. |
| [Themes](/docs/plugins/themes) | User | A personal color-theme picker: one palette per light mode and one per dark, built-in or your own base16 schemes. |
diff --git a/packages/app/src/components/SchemaConfigEditor.dom.test.tsx b/packages/app/src/components/SchemaConfigEditor.dom.test.tsx
index 6529cf860..14ae7ecc2 100644
--- a/packages/app/src/components/SchemaConfigEditor.dom.test.tsx
+++ b/packages/app/src/components/SchemaConfigEditor.dom.test.tsx
@@ -123,13 +123,12 @@ afterEach(() => {
});
describe('SchemaConfigEditor — toggle and default view', () => {
- test('renders a Source/Fields toggle and defaults to the Source view', () => {
+ test('renders a Source/Fields toggle without a maturity tag and defaults to Source', () => {
renderEditor(MAPPED_SCHEMA);
expect(fieldsSegment()).toBeDefined();
expect(sourceSegment()).toBeDefined();
- // The feature-beta tag marks the schema editor surface.
- expect(screen.getByText('Beta')).toBeDefined();
+ expect(screen.queryByText('Beta')).toBeNull();
const viewer = screen.getByTestId('mock-text-viewer');
expect(viewer.getAttribute('data-src')).toBe(
diff --git a/packages/app/src/components/SchemaConfigEditor.tsx b/packages/app/src/components/SchemaConfigEditor.tsx
index 8aca30939..cf64a667a 100644
--- a/packages/app/src/components/SchemaConfigEditor.tsx
+++ b/packages/app/src/components/SchemaConfigEditor.tsx
@@ -24,7 +24,6 @@ import { useEffect, useState } from 'react';
import { EditorModeToggle } from '@/components/EditorModeToggle';
import { NotInSidebarIndicator } from '@/components/NotInSidebarIndicator';
import { FrontmatterSchemaFieldEditor } from '@/components/settings/frontmatter-schema-field-editor';
-import { PluginBetaBadge } from '@/components/settings/PluginBetaBadge';
import { TextViewer } from '@/components/TextViewer';
import { useProjectLintConfig } from '@/editor/lint-config-client';
import { type LintConfigViewMode, useLintConfigViewMode } from '@/editor/useLintConfigViewMode';
@@ -94,7 +93,7 @@ export function SchemaConfigEditor({ assetPath }: SchemaConfigEditorProps) {
entry={{ kind: 'asset', path: assetPath }}
className="shrink-0 border-b bg-background px-3 py-1.5"
/>
- <div className="relative flex shrink-0 items-center justify-center border-b bg-background py-2">
+ <div className="flex shrink-0 items-center justify-center border-b bg-background py-2">
<EditorModeToggle
isSourceMode={isSourceMode}
onModeChange={(next) => setViewMode(next === 'source' ? 'source' : 'rules')}
@@ -103,11 +102,6 @@ export function SchemaConfigEditor({ assetPath }: SchemaConfigEditorProps) {
sourceLabel={t`Source`}
wysiwygDisabledReason={t`Field editing is available for schema files mapped in the Frontmatter schemas plugin`}
/>
- {/* Absolute so the mode toggle stays visually centered. Denser than the
- Badge default because this one sits in the editor toolbar beside the
- mode toggle, not in a settings header — the settings surfaces use the
- default so Beta and Scope badges line up. */}
- <PluginBetaBadge className="absolute left-3 top-1/2 h-4 -translate-y-1/2 px-1 text-[10px]" />
</div>
{isSourceMode ? (
// Source is a CodeMirror viewer that owns its own scroll — full-bleed,
diff --git a/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsx b/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsx
index 9762a10d6..8955e8a5d 100644
--- a/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsx
+++ b/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsx
@@ -273,10 +273,10 @@ describe('FrontmatterPluginSection — schema browser', () => {
expect(consumeSchemaFieldsView('schemas/local.schema.json')).toBe(true);
});
- test('the section header carries the feature-beta tag', () => {
+ test('the section header has no maturity tag', () => {
renderSection();
const header = document.getElementById('settings-plugin-frontmatter-title')?.parentElement;
- expect(header?.textContent).toContain('Beta');
+ expect(header?.textContent).not.toContain('Beta');
});
test('the appliesTo input names the pattern grammar with an example glob', () => {
diff --git a/packages/app/src/components/settings/LintingSection.dom.test.tsx b/packages/app/src/components/settings/LintingSection.dom.test.tsx
index 3f4950d16..fe09ee58e 100644
--- a/packages/app/src/components/settings/LintingSection.dom.test.tsx
+++ b/packages/app/src/components/settings/LintingSection.dom.test.tsx
@@ -178,11 +178,8 @@ describe('ProjectPluginsManageSection', () => {
expect(screen.getByTestId('settings-plugins-audit-pointer').textContent).toContain(
'Run a project audit from the Problems panel',
);
- // The frontmatter plugin is feature-beta; markdownlint is not.
const list = screen.getByTestId('settings-plugins-list');
- const rows = within(list).getAllByText('Beta');
- expect(rows).toHaveLength(1);
- expect(rows[0]?.closest('label')?.textContent).toContain('Frontmatter schemas');
+ expect(within(list).queryByText('Beta')).toBeNull();
});
test('every plugin toggle is described by its own row description', () => {
@@ -328,10 +325,11 @@ describe('UserPluginsManageSection', () => {
expect(window.location.hash).toBe('#settings/plugin:theme');
});
- test('lists a user-scope Slides toggle beside Themes', () => {
+ test('lists a user-scope Slides toggle beside Themes and labels Slidev as beta', () => {
render(<UserPluginsManageSection userBinding={null} />);
expect(screen.getByTestId('settings-plugin-toggle-slides')).toBeDefined();
expect(screen.getByTestId('settings-plugin-toggle-theme')).toBeDefined();
+ expect(screen.getByText('Slidev').closest('label')?.textContent).toContain('Beta');
});
test('enabling Slides writes the user-scope enabled patch and offers its panel', async () => {
diff --git a/packages/app/src/components/settings/LintingSection.tsx b/packages/app/src/components/settings/LintingSection.tsx
index c61fda337..0ede8d5b3 100644
--- a/packages/app/src/components/settings/LintingSection.tsx
+++ b/packages/app/src/components/settings/LintingSection.tsx
@@ -140,7 +140,6 @@ export function ProjectPluginsManageSection() {
className="inline-flex items-center gap-1.5 text-sm font-medium"
>
{plugin.label}
- {plugin.id === 'frontmatter' ? <PluginBetaBadge /> : null}
</Label>
<p id={descriptionId} className="text-1sm text-muted-foreground">
<PluginManageDescription id={plugin.id} />
@@ -715,7 +714,6 @@ export function FrontmatterPluginSection() {
<PluginSectionHeader
titleId="settings-plugin-frontmatter-title"
title={t`Frontmatter schemas`}
- beta
docUrl={pluginDocUrl('frontmatter')}
>
<Trans>
diff --git a/packages/app/src/components/settings/PluginBetaBadge.tsx b/packages/app/src/components/settings/PluginBetaBadge.tsx
index 28c32f2c2..6528f8dfe 100644
--- a/packages/app/src/components/settings/PluginBetaBadge.tsx
+++ b/packages/app/src/components/settings/PluginBetaBadge.tsx
@@ -1,8 +1,6 @@
/**
- * Feature-maturity "Beta" tag for a plugin — always visible, about the feature,
- * not the build (mirrors the ACP AgentBetaBadge). Rendered on every surface the
- * feature owns: the Plugins manage row, the plugin's settings panel header, and
- * (for frontmatter schemas) the schema file editor.
+ * Feature-maturity "Beta" tag for a plugin — about the feature, not the build
+ * (mirrors the ACP AgentBetaBadge). Render it on every surface a beta plugin owns.
*
* Sizing is the `Badge` default on purpose. This badge used to hard-code a
* smaller `h-4 px-1 text-[10px]`, which is invisible while a header carries only
@@ -10,16 +8,14 @@
* `ScopeBadge`, which uses the default, and the pair came out visibly mismatched.
* `Badge` has no size variant, so the smaller values were a one-off override;
* the default is the design-system size every other badge in the app uses.
- * Callers that genuinely need a denser badge pass the sizing through
- * `className` (tailwind-merge lets it win over the base).
*/
import { Trans } from '@lingui/react/macro';
import { Badge } from '@/components/ui/badge';
-export function PluginBetaBadge({ className }: { readonly className?: string }) {
+export function PluginBetaBadge() {
return (
- <Badge variant="gray" className={className}>
+ <Badge variant="gray">
<Trans>Beta</Trans>
</Badge>
);