@angeloashmore/prismic-cli-poc 0.0.0-pr.8.b80fefa → 0.0.0-pr.9.5366ece

package/src/custom-type-add-field-uid.ts

@@ -6,6 +6,7 @@ import * as v from "valibot";
 
 import { buildTypes } from "./codegen-types";
 import { findUpward } from "./lib/file";
+import { parseFieldPath, validateNestedFieldPath } from "./lib/field-path";
 import { stringify } from "./lib/json";
 import { humanReadable } from "./lib/string";
 
@@ -76,6 +77,22 @@ export async function customTypeAddFieldUid(): Promise<void> {
 		return;
 	}
 
+	// Parse and validate field path
+	const fieldPath = parseFieldPath(fieldId);
+	const pathValidation = validateNestedFieldPath(fieldPath);
+	if (!pathValidation.ok) {
+		console.error(pathValidation.error);
+		process.exitCode = 1;
+		return;
+	}
+
+	// UID fields cannot be nested in groups
+	if (fieldPath.type === "nested") {
+		console.error("UID fields cannot be nested inside groups");
+		process.exitCode = 1;
+		return;
+	}
+
 	// Find the custom type file
 	const projectRoot = await findUpward("package.json");
 	if (!projectRoot) {

package/src/custom-type-add-field.ts

@@ -5,6 +5,7 @@ import { customTypeAddFieldColor } from "./custom-type-add-field-color";
 import { customTypeAddFieldDate } from "./custom-type-add-field-date";
 import { customTypeAddFieldEmbed } from "./custom-type-add-field-embed";
 import { customTypeAddFieldGeoPoint } from "./custom-type-add-field-geo-point";
+import { customTypeAddFieldGroup } from "./custom-type-add-field-group";
 import { customTypeAddFieldImage } from "./custom-type-add-field-image";
 import { customTypeAddFieldKeyText } from "./custom-type-add-field-key-text";
 import { customTypeAddFieldLink } from "./custom-type-add-field-link";
@@ -26,6 +27,7 @@ FIELD TYPES
   date                   Date picker
   embed                  Embed (oEmbed)
   geo-point              Geographic coordinates
+  group                  Repeatable group of fields
   image                  Image
   key-text               Single-line text
   link                   Any link type
@@ -76,6 +78,9 @@ export async function customTypeAddField(): Promise<void> {
 		case "geo-point":
 			await customTypeAddFieldGeoPoint();
 			break;
+		case "group":
+			await customTypeAddFieldGroup();
+			break;
 		case "image":
 			await customTypeAddFieldImage();
 			break;

package/src/index.ts

@@ -16,6 +16,7 @@ import { pull } from "./pull";
 import { push } from "./push";
 import { repo } from "./repo";
 import { slice } from "./slice";
+import { skill } from "./skill";
 import { status } from "./status";
 import { token } from "./token";
 import { webhook } from "./webhook";
@@ -42,6 +43,7 @@ COMMANDS
   push        Push types and slices to Prismic
   codegen     Generate code from Prismic models
   docs        Fetch documentation from Prismic
+  skill       Manage Prismic AI skills
   preview     Manage preview configurations
   token       Manage API tokens in a repository
   webhook     Manage webhooks in a repository
@@ -112,6 +114,9 @@ if (version) {
 		case "docs":
 			await docs();
 			break;
+		case "skill":
+			await skill();
+			break;
 		case "preview":
 			await preview();
 			break;

package/src/lib/field-path.ts

@@ -0,0 +1,81 @@
+export type FieldPath =
+	| { type: "top-level"; fieldId: string }
+	| { type: "nested"; groupId: string; nestedFieldId: string };
+
+export function parseFieldPath(fieldId: string): FieldPath {
+	const parts = fieldId.split(".");
+
+	if (parts.length === 1) {
+		return { type: "top-level", fieldId };
+	}
+
+	if (parts.length === 2) {
+		return { type: "nested", groupId: parts[0], nestedFieldId: parts[1] };
+	}
+
+	// More than 2 parts means nested groups which aren't supported
+	return { type: "nested", groupId: parts[0], nestedFieldId: parts.slice(1).join(".") };
+}
+
+export type GroupFieldResult =
+	| { ok: true; group: { config: { fields: Record<string, unknown> } } }
+	| { ok: false; error: string };
+
+export function isGroupField(field: unknown): field is { type: "Group"; config: { fields: Record<string, unknown> } } {
+	return (
+		typeof field === "object" &&
+		field !== null &&
+		"type" in field &&
+		field.type === "Group" &&
+		"config" in field &&
+		typeof field.config === "object" &&
+		field.config !== null &&
+		"fields" in field.config
+	);
+}
+
+export function findGroupInTab(
+	tabFields: Record<string, unknown>,
+	groupId: string,
+	tabName: string,
+): GroupFieldResult {
+	const field = tabFields[groupId];
+
+	if (!field) {
+		return { ok: false, error: `Group "${groupId}" not found in tab "${tabName}"` };
+	}
+
+	if (!isGroupField(field)) {
+		return { ok: false, error: `Field "${groupId}" is not a group` };
+	}
+
+	return { ok: true, group: field };
+}
+
+export function findGroupInVariation(
+	primary: Record<string, unknown>,
+	groupId: string,
+	variationId: string,
+): GroupFieldResult {
+	const field = primary[groupId];
+
+	if (!field) {
+		return { ok: false, error: `Group "${groupId}" not found in variation "${variationId}"` };
+	}
+
+	if (!isGroupField(field)) {
+		return { ok: false, error: `Field "${groupId}" is not a group` };
+	}
+
+	return { ok: true, group: field };
+}
+
+export function validateNestedFieldPath(fieldPath: FieldPath): { ok: true } | { ok: false; error: string } {
+	if (fieldPath.type === "nested" && fieldPath.nestedFieldId.includes(".")) {
+		return {
+			ok: false,
+			error: `Nested groups not supported. Use: group.field`,
+		};
+	}
+	return { ok: true };
+}

package/src/page-type-add-field-boolean.ts

@@ -6,6 +6,8 @@ import * as v from "valibot";
 
 import { buildTypes } from "./codegen-types";
 import { findUpward } from "./lib/file";
+import { findGroupInTab, isGroupField, parseFieldPath, validateNestedFieldPath } from "./lib/field-path";
+import { type Framework, detectFrameworkInfo } from "./lib/framework";
 import { stringify } from "./lib/json";
 import { humanReadable } from "./lib/string";
 
@@ -43,6 +45,17 @@ const CustomTypeSchema = v.object({
 	json: v.record(v.string(), v.record(v.string(), v.unknown())),
 });
 
+function getDocsPath(framework: Framework): string {
+	switch (framework) {
+		case "next":
+			return "nextjs/with-cli";
+		case "nuxt":
+			return "nuxt/with-cli";
+		case "sveltekit":
+			return "sveltekit/with-cli";
+	}
+}
+
 export async function pageTypeAddFieldBoolean(): Promise<void> {
 	const {
 		values: {
@@ -88,6 +101,15 @@ export async function pageTypeAddFieldBoolean(): Promise<void> {
 		return;
 	}
 
+	// Parse and validate field path
+	const fieldPath = parseFieldPath(fieldId);
+	const pathValidation = validateNestedFieldPath(fieldPath);
+	if (!pathValidation.ok) {
+		console.error(pathValidation.error);
+		process.exitCode = 1;
+		return;
+	}
+
 	// Find the page type file
 	const projectRoot = await findUpward("package.json");
 	if (!projectRoot) {
@@ -134,20 +156,11 @@ export async function pageTypeAddFieldBoolean(): Promise<void> {
 		model.json[targetTab] = {};
 	}
 
-	// Check if field already exists in any tab
-	for (const [tabName, tabFields] of Object.entries(model.json)) {
-		if (tabFields[fieldId]) {
-			console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
-			process.exitCode = 1;
-			return;
-		}
-	}
-
 	// Build field definition
 	const fieldDefinition: BooleanField = {
 		type: "Boolean",
 		config: {
-			label: label ?? humanReadable(fieldId),
+			label: label ?? humanReadable(fieldPath.type === "nested" ? fieldPath.nestedFieldId : fieldId),
 			...(defaultValue && { default_value: true }),
 			...(trueLabel && { placeholder_true: trueLabel }),
 			...(falseLabel && { placeholder_false: falseLabel }),
@@ -155,7 +168,36 @@ export async function pageTypeAddFieldBoolean(): Promise<void> {
 	};
 
 	// Add field to model
-	model.json[targetTab][fieldId] = fieldDefinition;
+	if (fieldPath.type === "nested") {
+		const groupResult = findGroupInTab(model.json[targetTab], fieldPath.groupId, targetTab);
+		if (!groupResult.ok) {
+			console.error(groupResult.error);
+			process.exitCode = 1;
+			return;
+		}
+		if (groupResult.group.config.fields[fieldPath.nestedFieldId]) {
+			console.error(`Field "${fieldPath.nestedFieldId}" already exists in group "${fieldPath.groupId}"`);
+			process.exitCode = 1;
+			return;
+		}
+		groupResult.group.config.fields[fieldPath.nestedFieldId] = fieldDefinition;
+	} else {
+		for (const [tabName, tabFields] of Object.entries(model.json)) {
+			if (tabFields[fieldId]) {
+				console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
+				process.exitCode = 1;
+				return;
+			}
+			for (const [groupFieldId, groupField] of Object.entries(tabFields)) {
+				if (isGroupField(groupField) && groupField.config.fields[fieldId]) {
+					console.error(`Field "${fieldId}" already exists in group "${groupFieldId}" in tab "${tabName}"`);
+					process.exitCode = 1;
+					return;
+				}
+			}
+		}
+		model.json[targetTab][fieldId] = fieldDefinition;
+	}
 
 	// Write updated model
 	try {
@@ -170,7 +212,11 @@ export async function pageTypeAddFieldBoolean(): Promise<void> {
 		return;
 	}
 
-	console.info(`Added field "${fieldId}" (Boolean) to "${targetTab}" tab in ${typeId}`);
+	if (fieldPath.type === "nested") {
+		console.info(`Added field "${fieldPath.nestedFieldId}" (Boolean) to group "${fieldPath.groupId}" in ${typeId}`);
+	} else {
+		console.info(`Added field "${fieldId}" (Boolean) to "${targetTab}" tab in ${typeId}`);
+	}
 
 	try {
 		await buildTypes({ output: types });
@@ -181,5 +227,12 @@ export async function pageTypeAddFieldBoolean(): Promise<void> {
 
 	console.info();
 	console.info("Next: Add more fields with `prismic page-type add-field`");
-	console.info("      Run `prismic status` when done to find next steps");
+
+	const frameworkInfo = await detectFrameworkInfo();
+	if (frameworkInfo?.framework) {
+		const docsPath = getDocsPath(frameworkInfo.framework);
+		console.info(
+			`      Run \`prismic docs ${docsPath}#write-page-components\` to learn how to implement a page file`,
+		);
+	}
 }

package/src/page-type-add-field-color.ts

@@ -6,6 +6,8 @@ import * as v from "valibot";
 
 import { buildTypes } from "./codegen-types";
 import { findUpward } from "./lib/file";
+import { findGroupInTab, isGroupField, parseFieldPath, validateNestedFieldPath } from "./lib/field-path";
+import { type Framework, detectFrameworkInfo } from "./lib/framework";
 import { stringify } from "./lib/json";
 import { humanReadable } from "./lib/string";
 
@@ -41,6 +43,17 @@ const CustomTypeSchema = v.object({
 	json: v.record(v.string(), v.record(v.string(), v.unknown())),
 });
 
+function getDocsPath(framework: Framework): string {
+	switch (framework) {
+		case "next":
+			return "nextjs/with-cli";
+		case "nuxt":
+			return "nuxt/with-cli";
+		case "sveltekit":
+			return "sveltekit/with-cli";
+	}
+}
+
 export async function pageTypeAddFieldColor(): Promise<void> {
 	const {
 		values: { help, tab, label, placeholder, types },
@@ -76,6 +89,15 @@ export async function pageTypeAddFieldColor(): Promise<void> {
 		return;
 	}
 
+	// Parse and validate field path
+	const fieldPath = parseFieldPath(fieldId);
+	const pathValidation = validateNestedFieldPath(fieldPath);
+	if (!pathValidation.ok) {
+		console.error(pathValidation.error);
+		process.exitCode = 1;
+		return;
+	}
+
 	// Find the page type file
 	const projectRoot = await findUpward("package.json");
 	if (!projectRoot) {
@@ -122,26 +144,46 @@ export async function pageTypeAddFieldColor(): Promise<void> {
 		model.json[targetTab] = {};
 	}
 
-	// Check if field already exists in any tab
-	for (const [tabName, tabFields] of Object.entries(model.json)) {
-		if (tabFields[fieldId]) {
-			console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
-			process.exitCode = 1;
-			return;
-		}
-	}
-
 	// Build field definition
 	const fieldDefinition: Color = {
 		type: "Color",
 		config: {
-			label: label ?? humanReadable(fieldId),
+			label: label ?? humanReadable(fieldPath.type === "nested" ? fieldPath.nestedFieldId : fieldId),
 			...(placeholder && { placeholder }),
 		},
 	};
 
 	// Add field to model
-	model.json[targetTab][fieldId] = fieldDefinition;
+	if (fieldPath.type === "nested") {
+		const groupResult = findGroupInTab(model.json[targetTab], fieldPath.groupId, targetTab);
+		if (!groupResult.ok) {
+			console.error(groupResult.error);
+			process.exitCode = 1;
+			return;
+		}
+		if (groupResult.group.config.fields[fieldPath.nestedFieldId]) {
+			console.error(`Field "${fieldPath.nestedFieldId}" already exists in group "${fieldPath.groupId}"`);
+			process.exitCode = 1;
+			return;
+		}
+		groupResult.group.config.fields[fieldPath.nestedFieldId] = fieldDefinition;
+	} else {
+		for (const [tabName, tabFields] of Object.entries(model.json)) {
+			if (tabFields[fieldId]) {
+				console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
+				process.exitCode = 1;
+				return;
+			}
+			for (const [groupFieldId, groupField] of Object.entries(tabFields)) {
+				if (isGroupField(groupField) && groupField.config.fields[fieldId]) {
+					console.error(`Field "${fieldId}" already exists in group "${groupFieldId}" in tab "${tabName}"`);
+					process.exitCode = 1;
+					return;
+				}
+			}
+		}
+		model.json[targetTab][fieldId] = fieldDefinition;
+	}
 
 	// Write updated model
 	try {
@@ -156,7 +198,11 @@ export async function pageTypeAddFieldColor(): Promise<void> {
 		return;
 	}
 
-	console.info(`Added field "${fieldId}" (Color) to "${targetTab}" tab in ${typeId}`);
+	if (fieldPath.type === "nested") {
+		console.info(`Added field "${fieldPath.nestedFieldId}" (Color) to group "${fieldPath.groupId}" in ${typeId}`);
+	} else {
+		console.info(`Added field "${fieldId}" (Color) to "${targetTab}" tab in ${typeId}`);
+	}
 
 	try {
 		await buildTypes({ output: types });
@@ -167,5 +213,12 @@ export async function pageTypeAddFieldColor(): Promise<void> {
 
 	console.info();
 	console.info("Next: Add more fields with `prismic page-type add-field`");
-	console.info("      Run `prismic status` when done to find next steps");
+
+	const frameworkInfo = await detectFrameworkInfo();
+	if (frameworkInfo?.framework) {
+		const docsPath = getDocsPath(frameworkInfo.framework);
+		console.info(
+			`      Run \`prismic docs ${docsPath}#write-page-components\` to learn how to implement a page file`,
+		);
+	}
 }

package/src/page-type-add-field-date.ts

@@ -6,6 +6,8 @@ import * as v from "valibot";
 
 import { buildTypes } from "./codegen-types";
 import { findUpward } from "./lib/file";
+import { findGroupInTab, isGroupField, parseFieldPath, validateNestedFieldPath } from "./lib/field-path";
+import { type Framework, detectFrameworkInfo } from "./lib/framework";
 import { stringify } from "./lib/json";
 import { humanReadable } from "./lib/string";
 
@@ -42,6 +44,17 @@ const CustomTypeSchema = v.object({
 	json: v.record(v.string(), v.record(v.string(), v.unknown())),
 });
 
+function getDocsPath(framework: Framework): string {
+	switch (framework) {
+		case "next":
+			return "nextjs/with-cli";
+		case "nuxt":
+			return "nuxt/with-cli";
+		case "sveltekit":
+			return "sveltekit/with-cli";
+	}
+}
+
 export async function pageTypeAddFieldDate(): Promise<void> {
 	const {
 		values: { help, tab, label, placeholder, default: defaultValue, types },
@@ -78,6 +91,15 @@ export async function pageTypeAddFieldDate(): Promise<void> {
 		return;
 	}
 
+	// Parse and validate field path
+	const fieldPath = parseFieldPath(fieldId);
+	const pathValidation = validateNestedFieldPath(fieldPath);
+	if (!pathValidation.ok) {
+		console.error(pathValidation.error);
+		process.exitCode = 1;
+		return;
+	}
+
 	// Find the page type file
 	const projectRoot = await findUpward("package.json");
 	if (!projectRoot) {
@@ -124,27 +146,47 @@ export async function pageTypeAddFieldDate(): Promise<void> {
 		model.json[targetTab] = {};
 	}
 
-	// Check if field already exists in any tab
-	for (const [tabName, tabFields] of Object.entries(model.json)) {
-		if (tabFields[fieldId]) {
-			console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
-			process.exitCode = 1;
-			return;
-		}
-	}
-
 	// Build field definition
 	const fieldDefinition: DateField = {
 		type: "Date",
 		config: {
-			label: label ?? humanReadable(fieldId),
+			label: label ?? humanReadable(fieldPath.type === "nested" ? fieldPath.nestedFieldId : fieldId),
 			...(placeholder && { placeholder }),
 			...(defaultValue && { default: defaultValue }),
 		},
 	};
 
 	// Add field to model
-	model.json[targetTab][fieldId] = fieldDefinition;
+	if (fieldPath.type === "nested") {
+		const groupResult = findGroupInTab(model.json[targetTab], fieldPath.groupId, targetTab);
+		if (!groupResult.ok) {
+			console.error(groupResult.error);
+			process.exitCode = 1;
+			return;
+		}
+		if (groupResult.group.config.fields[fieldPath.nestedFieldId]) {
+			console.error(`Field "${fieldPath.nestedFieldId}" already exists in group "${fieldPath.groupId}"`);
+			process.exitCode = 1;
+			return;
+		}
+		groupResult.group.config.fields[fieldPath.nestedFieldId] = fieldDefinition;
+	} else {
+		for (const [tabName, tabFields] of Object.entries(model.json)) {
+			if (tabFields[fieldId]) {
+				console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
+				process.exitCode = 1;
+				return;
+			}
+			for (const [groupFieldId, groupField] of Object.entries(tabFields)) {
+				if (isGroupField(groupField) && groupField.config.fields[fieldId]) {
+					console.error(`Field "${fieldId}" already exists in group "${groupFieldId}" in tab "${tabName}"`);
+					process.exitCode = 1;
+					return;
+				}
+			}
+		}
+		model.json[targetTab][fieldId] = fieldDefinition;
+	}
 
 	// Write updated model
 	try {
@@ -159,7 +201,11 @@ export async function pageTypeAddFieldDate(): Promise<void> {
 		return;
 	}
 
-	console.info(`Added field "${fieldId}" (Date) to "${targetTab}" tab in ${typeId}`);
+	if (fieldPath.type === "nested") {
+		console.info(`Added field "${fieldPath.nestedFieldId}" (Date) to group "${fieldPath.groupId}" in ${typeId}`);
+	} else {
+		console.info(`Added field "${fieldId}" (Date) to "${targetTab}" tab in ${typeId}`);
+	}
 
 	try {
 		await buildTypes({ output: types });
@@ -170,5 +216,12 @@ export async function pageTypeAddFieldDate(): Promise<void> {
 
 	console.info();
 	console.info("Next: Add more fields with `prismic page-type add-field`");
-	console.info("      Run `prismic status` when done to find next steps");
+
+	const frameworkInfo = await detectFrameworkInfo();
+	if (frameworkInfo?.framework) {
+		const docsPath = getDocsPath(frameworkInfo.framework);
+		console.info(
+			`      Run \`prismic docs ${docsPath}#write-page-components\` to learn how to implement a page file`,
+		);
+	}
 }

package/src/page-type-add-field-embed.ts

@@ -6,6 +6,8 @@ import * as v from "valibot";
 
 import { buildTypes } from "./codegen-types";
 import { findUpward } from "./lib/file";
+import { findGroupInTab, isGroupField, parseFieldPath, validateNestedFieldPath } from "./lib/field-path";
+import { type Framework, detectFrameworkInfo } from "./lib/framework";
 import { stringify } from "./lib/json";
 import { humanReadable } from "./lib/string";
 
@@ -41,6 +43,17 @@ const CustomTypeSchema = v.object({
 	json: v.record(v.string(), v.record(v.string(), v.unknown())),
 });
 
+function getDocsPath(framework: Framework): string {
+	switch (framework) {
+		case "next":
+			return "nextjs/with-cli";
+		case "nuxt":
+			return "nuxt/with-cli";
+		case "sveltekit":
+			return "sveltekit/with-cli";
+	}
+}
+
 export async function pageTypeAddFieldEmbed(): Promise<void> {
 	const {
 		values: { help, tab, label, placeholder, types },
@@ -76,6 +89,15 @@ export async function pageTypeAddFieldEmbed(): Promise<void> {
 		return;
 	}
 
+	// Parse and validate field path
+	const fieldPath = parseFieldPath(fieldId);
+	const pathValidation = validateNestedFieldPath(fieldPath);
+	if (!pathValidation.ok) {
+		console.error(pathValidation.error);
+		process.exitCode = 1;
+		return;
+	}
+
 	// Find the page type file
 	const projectRoot = await findUpward("package.json");
 	if (!projectRoot) {
@@ -122,26 +144,46 @@ export async function pageTypeAddFieldEmbed(): Promise<void> {
 		model.json[targetTab] = {};
 	}
 
-	// Check if field already exists in any tab
-	for (const [tabName, tabFields] of Object.entries(model.json)) {
-		if (tabFields[fieldId]) {
-			console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
-			process.exitCode = 1;
-			return;
-		}
-	}
-
 	// Build field definition
 	const fieldDefinition: Embed = {
 		type: "Embed",
 		config: {
-			label: label ?? humanReadable(fieldId),
+			label: label ?? humanReadable(fieldPath.type === "nested" ? fieldPath.nestedFieldId : fieldId),
 			...(placeholder && { placeholder }),
 		},
 	};
 
 	// Add field to model
-	model.json[targetTab][fieldId] = fieldDefinition;
+	if (fieldPath.type === "nested") {
+		const groupResult = findGroupInTab(model.json[targetTab], fieldPath.groupId, targetTab);
+		if (!groupResult.ok) {
+			console.error(groupResult.error);
+			process.exitCode = 1;
+			return;
+		}
+		if (groupResult.group.config.fields[fieldPath.nestedFieldId]) {
+			console.error(`Field "${fieldPath.nestedFieldId}" already exists in group "${fieldPath.groupId}"`);
+			process.exitCode = 1;
+			return;
+		}
+		groupResult.group.config.fields[fieldPath.nestedFieldId] = fieldDefinition;
+	} else {
+		for (const [tabName, tabFields] of Object.entries(model.json)) {
+			if (tabFields[fieldId]) {
+				console.error(`Field "${fieldId}" already exists in tab "${tabName}"`);
+				process.exitCode = 1;
+				return;
+			}
+			for (const [groupFieldId, groupField] of Object.entries(tabFields)) {
+				if (isGroupField(groupField) && groupField.config.fields[fieldId]) {
+					console.error(`Field "${fieldId}" already exists in group "${groupFieldId}" in tab "${tabName}"`);
+					process.exitCode = 1;
+					return;
+				}
+			}
+		}
+		model.json[targetTab][fieldId] = fieldDefinition;
+	}
 
 	// Write updated model
 	try {
@@ -156,7 +198,11 @@ export async function pageTypeAddFieldEmbed(): Promise<void> {
 		return;
 	}
 
-	console.info(`Added field "${fieldId}" (Embed) to "${targetTab}" tab in ${typeId}`);
+	if (fieldPath.type === "nested") {
+		console.info(`Added field "${fieldPath.nestedFieldId}" (Embed) to group "${fieldPath.groupId}" in ${typeId}`);
+	} else {
+		console.info(`Added field "${fieldId}" (Embed) to "${targetTab}" tab in ${typeId}`);
+	}
 
 	try {
 		await buildTypes({ output: types });
@@ -167,5 +213,12 @@ export async function pageTypeAddFieldEmbed(): Promise<void> {
 
 	console.info();
 	console.info("Next: Add more fields with `prismic page-type add-field`");
-	console.info("      Run `prismic status` when done to find next steps");
+
+	const frameworkInfo = await detectFrameworkInfo();
+	if (frameworkInfo?.framework) {
+		const docsPath = getDocsPath(frameworkInfo.framework);
+		console.info(
+			`      Run \`prismic docs ${docsPath}#write-page-components\` to learn how to implement a page file`,
+		);
+	}
 }