"use client"; import { useState } from "react"; import { useRouter } from "next/navigation"; interface DocFormProps { mode: "create" | "edit"; slug?: string; secret: string; existingFolders?: Record; initial?: { title?: string; body?: string; section?: "docs" | "writeups" | "research" | "notes"; type?: "documentation" | "writeup" | "research" | "note"; status?: "published" | "draft"; tags?: string[]; author?: string; extraFields?: Record; }; } const SECTION_OPTIONS = ["docs", "writeups", "research", "notes"] as const; const TYPE_OPTIONS = ["documentation", "writeup", "research", "note"] as const; export default function DocForm({ mode, slug, secret, existingFolders, initial, }: DocFormProps) { const router = useRouter(); const [loading, setLoading] = useState(false); const [error, setError] = useState(null); const [title, setTitle] = useState(initial?.title ?? ""); const [slugInput, setSlugInput] = useState(""); const [body, setBody] = useState(initial?.body ?? ""); const [section, setSection] = useState(initial?.section ?? "docs"); const [type, setType] = useState(initial?.type ?? "documentation"); const [status, setStatus] = useState(initial?.status ?? "published"); const [tags, setTags] = useState(initial?.tags?.join(", ") ?? ""); const [author, setAuthor] = useState(initial?.author ?? ""); const [parentFolder, setParentFolder] = useState(""); // Extract existing custom fields from initial for edit mode const [customFields, setCustomFields] = useState< Array<{ key: string; value: string }> >(() => { if (initial?.extraFields) { return Object.entries(initial.extraFields) .filter(([k, v]) => k !== "slug" && v !== undefined && v !== null) .map(([k, v]) => ({ key: k, value: typeof v === "string" ? v : JSON.stringify(v) })) .filter((f) => f.value); } return []; }); const tagList = tags .split(",") .map((t) => t.trim()) .filter(Boolean); const isEdit = mode === "edit"; const effectiveSlug = isEdit ? (slug ?? "") : parentFolder ? `${parentFolder}/${slugInput}`.replace(/^\/+/, "").replace(/\/+/g, "/") : slugInput; const availableFolders = existingFolders?.[section] ?? []; const baseInputCls = "w-full px-3 py-2 bg-[#0f1011] border border-[#23252a] rounded text-[#f7f8f8] placeholder-[#62666d] focus:outline-none focus:border-[#5e6ad2] focus:ring-1 focus:ring-[#5e6ad2]"; const baseSelectCls = baseInputCls; function addCustomField() { setCustomFields([...customFields, { key: "", value: "" }]); } function updateCustomField(index: number, field: "key" | "value", value: string) { const updated = [...customFields]; updated[index][field] = value; setCustomFields(updated); } function removeCustomField(index: number) { setCustomFields(customFields.filter((_, i) => i !== index)); } async function handleSubmit(e: React.FormEvent) { e.preventDefault(); setLoading(true); setError(null); if (!effectiveSlug || !title || !body) { setError("Slug, title, and body are required."); setLoading(false); return; } const payload: Record = { title, body, slug: effectiveSlug, section, type, status, author, tags: tagList, }; for (const field of customFields) { if (field.key.trim() && field.value.trim()) { payload[field.key.trim()] = field.value.trim(); } } try { let res: Response; if (mode === "create") { res = await fetch("/api/docs", { method: "POST", headers: { "Content-Type": "application/json", "x-webhook-secret": secret, }, body: JSON.stringify(payload), }); } else { const editSlug = slug ?? ""; res = await fetch(`/api/docs/${editSlug}`, { method: "PUT", headers: { "Content-Type": "application/json", "x-webhook-secret": secret, }, body: JSON.stringify(payload), }); } if (!res.ok) { const data = await res.json().catch(() => ({})); throw new Error(data.error ?? "Save failed"); } const result = await res.json(); router.push(result.doc?.slug ? `/${result.doc.slug}` : "/"); } catch (err) { setError(err instanceof Error ? err.message : String(err)); } finally { setLoading(false); } } return (
{error && (
{error}
)} {/* Title */}
setTitle(e.target.value)} className={baseInputCls} required />
{/* Section + Type + Status */}
{/* Folder + Slug */}

Place inside an existing folder.

{isEdit ? ( ) : ( setSlugInput(e.target.value)} className={baseInputCls} placeholder="my-document-slug" required /> )}

Resolved: {effectiveSlug || section}

{/* Tags + Author */}
setTags(e.target.value)} className={baseInputCls} placeholder="comma, separated, tags" />
setAuthor(e.target.value)} className={baseInputCls} />
{/* Custom fields */}

Add extra frontmatter fields. Any field you add will be rendered as an auto-styled badge on the doc page based on its value.

{customFields.length > 0 && (
{customFields.map((field, i) => (
updateCustomField(i, "key", e.target.value)} className={baseInputCls} /> updateCustomField(i, "value", e.target.value)} className={baseInputCls} />
))}
)}
{/* Body */}