nebari-dev / nebari-dev/nebari-frames

Simplify the Frame authoring form to the lightweight Frame body

Open
#59 0 comments 0 reactions 1 assignee View on GitHub

@jbouder is already working on this.

Since Aug 20, 2026.

  • #75 by @jbouder — open
area: user experience 👩🏻‍💻 type: enhancement 💅🏼
Dominant language
Go
Stars
2
Forks
1
Avg merge
10h 55m
Merged PRs (30d)
9

Description

Motivation

The Frame content model is collapsing to a single free-form markdown body (Frame Spec v0.2 requires four frontmatter fields and defines no body structure). The authoring page in web/src/pages/FrameAuthoringPage.tsx still reflects the older, heavier model: a per-slot form (terminology, rules, skills, prompts, tool_specs, goals, style, norms, architecture, business_process) plus visibility/scope/maintainer metadata fields, driven by web/src/components/form/form-model.ts and the editors in web/src/components/form/ and web/src/components/slots/.

The result is a long form that asks an author to make many decisions before they can write anything, most of which are optional and several of which no longer map to how a Frame is stored or composed. Authoring a Frame should feel like writing a document, not filling in a schema.

Proposal

  • Reduce the authoring form to what a Frame actually needs: identity (name, description, version), the markdown body, and inheritance (extends/excludes).
  • Drop the per-slot editors and fold their content into the body editor. Keep the .frame.md markdown source editor as the power-user path.
  • Move fields that are declared metadata rather than authoring decisions (visibility, scope, maintainer) out of the primary flow - a collapsed "advanced"/metadata area, sensible defaults, or removed from the form entirely where the value is derivable.
  • Delete the form components and form-model branches that are no longer reachable, so the form has one source of truth.

Acceptance criteria

  • Creating and editing a Frame no longer presents the per-slot fields.
  • Existing Frames (including ones published under the slot schema) open and save correctly.
  • Round-tripping through the markdown source editor still works.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.