@notionx/create-notionx-app 1.0.0

package/dist/templates/lib/blog/translations.ts.tmpl

@@ -0,0 +1,52 @@
+// Locale-aware blog lookup. Falls back to the default-locale
+// translation when a target locale is missing (rule: hide).
+
+import {
+  pickTranslation,
+  hideWhenMissing,
+  mapNotionPageToLocalizedContentTranslation,
+} from "@notionx/core";
+import { i18n } from "@/lib/i18n";
+import { blogContract } from "@/lib/locale-contract";
+import type { NotionPageLike } from "@notionx/core";
+
+export type BlogTranslationExtra = {
+  summary: string;
+  tags: string[];
+};
+
+export type BlogTranslation = NonNullable<
+  ReturnType<typeof mapNotionPageToLocalizedContentTranslation<BlogTranslationExtra>>
+>;
+
+export function mapBlogTranslation(page: NotionPageLike): BlogTranslation | null {
+  return mapNotionPageToLocalizedContentTranslation<BlogTranslationExtra>(page, {
+    fields: {
+      title: "Title",
+      source: "Source",
+      locale: "Locale",
+      slug: "Slug",
+      published: "Published",
+    },
+    extraFields: {
+      summary: "Description",
+      tags: { field: "Tags", kind: "tags" },
+    },
+    isValidLocale: (locale) =>
+      (i18n.supportedLocales as readonly string[]).includes(locale),
+  });
+}
+
+export function pickBlogTranslation(
+  rows: readonly BlogTranslation[],
+  locale: string
+) {
+  return pickTranslation(rows, locale, blogContract, i18n.defaultLocale);
+}
+
+export function blogListForLocale(
+  rows: readonly BlogTranslation[],
+  locale: string
+) {
+  return hideWhenMissing(rows, locale);
+}

package/dist/templates/lib/content/models.ts.tmpl

@@ -0,0 +1,53 @@
+// Notion-backed content sources registered with the notionx
+// registry. To add another content source, run `notionx add <id>`
+// (or paste a new `defineContentSource({...})` block by hand and
+// append the variable to `contentSources` / `managedContentSources`).
+//
+// `siteSettingsSource` and `blocksSource` are *singleton* internal
+// sources that back `lib/site/settings.ts` and `components/page-blocks`
+// respectively. They are conditionally included based on the
+// `enableSiteSettings` / `enableBlocks` flags. They live in their
+// own `NOTION_*_DATA_SOURCE_ID` env vars so they can be shared
+// across content sources and edited without redeploying. They're
+// intentionally NOT in `contentSources` because they have no
+// public list/detail pages — only the home page, SEO metadata, and
+// page-blocks consume them. Operators can still see them in
+// `/admin/content-models` (they're in the package registry), and
+// can revalidate their KV cache from there.
+
+import {
+  defineContentSource,
+  type ContentSource,
+} from "@notionx/core/content";
+
+// BEGIN generated-content-sources
+// (Regenerated by `notionx add` / `notionx remove` / `notionx
+// update`. Do not edit between these markers — the next update
+// run will overwrite this block. To add a source by hand, use
+// `notionx add <id>`.)
+{{contentSourceDeclarations}}
+// END generated-content-sources
+
+// BEGIN generated-internal-sources
+// (Regenerated by `notionx add` / `notionx remove` / `notionx
+// update`. Do not edit between these markers.)
+{{internalSourceDeclarations}}
+// END generated-internal-sources
+
+// `contentSources` is the public list shown in admin nav and
+// iterated by search/revalidation. `managedContentSources`
+// additionally includes any internal singleton sources
+// (`blocksSource`, `siteSettingsSource`) so the worker registers
+// them with `@notionx/core`'s `createNotionxWorker({ sources })`.
+//
+// `{{contentSourceSourcesVarNames}}` is a comma-joined list of
+// `*Source` variable names for every installed content source.
+// `{{internalSourceVarNames}}` is the same for internal sources.
+export const contentSources = [
+{{contentSourceSourcesVarNames}},
+] as const;
+export const managedContentSources = [
+{{contentSourceSourcesVarNames}},
+{{internalSourceVarNames}},
+] as const;
+export type ContentSourceId = (typeof contentSources)[number]["id"];

package/dist/templates/lib/i18n/config.ts.tmpl

@@ -0,0 +1,18 @@
+// Project-level i18n config. Re-exports the runtime helpers from
+// `@notionx/core` so app code, route handlers, and components share
+// one set of locale constants. The supported locales are baked in
+// at scaffold time; use `npx notionx locale add <locale>` to extend
+// an existing project.
+
+import { defineI18nConfig } from "@notionx/core/i18n";
+
+export const i18n = defineI18nConfig({
+  defaultLocale: "{{defaultLocale}}",
+  supportedLocales: {{supportedLocalesJson}},
+});
+
+export type AppLocale = (typeof i18n.supportedLocales)[number];
+
+export function isAppLocale(value: string): value is AppLocale {
+  return (i18n.supportedLocales as readonly string[]).includes(value);
+}

package/dist/templates/lib/i18n/index.ts.tmpl

@@ -0,0 +1 @@
+export * from "./config";

package/dist/templates/lib/locale-contract/built-in.ts.tmpl

@@ -0,0 +1,19 @@
+// Built-in locale contracts re-exported under a project-friendly
+// import path. The list paths here are the canonical ones for the
+// starter: the blog content source list and the page detail route.
+
+import {
+  blogContract as coreBlogContract,
+  pagesContract as corePagesContract,
+  blocksContract as coreBlocksContract,
+  siteSettingsContract as coreSiteSettingsContract,
+} from "@notionx/core";
+
+export const blogContract = {
+  ...coreBlogContract,
+  listPath: "{{contentSourceListPath}}",
+};
+
+export const pagesContract = corePagesContract;
+export const blocksContract = coreBlocksContract;
+export const siteSettingsContract = coreSiteSettingsContract;

package/dist/templates/lib/locale-contract/index.ts.tmpl

@@ -0,0 +1,3 @@
+export * from "./built-in";
+export * from "./paths";
+export { defineLocaleContract } from "@notionx/core";

package/dist/templates/lib/locale-contract/paths.ts.tmpl

@@ -0,0 +1,29 @@
+// Thin wrappers around the core path helpers that bake the project's
+// default locale and the blog content source list path in. Route code
+// should import from this module rather than the core helpers directly
+// so the defaults stay consistent.
+
+import { i18n } from "@/lib/i18n";
+import {
+  localizedListPath as coreLocalizedListPath,
+  localizedDetailPathFor as coreLocalizedDetailPathFor,
+  stripLocalePrefix as coreStripLocalePrefix,
+} from "@notionx/core";
+import { blogContract } from "./built-in";
+
+export function blogListPath(locale: string) {
+  return coreLocalizedListPath(locale, blogContract, i18n.defaultLocale);
+}
+
+export function blogDetailPath(locale: string, slug: string) {
+  return coreLocalizedDetailPathFor(
+    locale,
+    slug,
+    blogContract,
+    i18n.defaultLocale
+  );
+}
+
+export function stripBlogLocale(path: string, locale: string) {
+  return coreStripLocalePrefix(path, locale);
+}

package/dist/templates/lib/pages/model.ts.tmpl

@@ -0,0 +1,16 @@
+// Notion-backed site pages. Pages are different from article-like
+// content sources: they define the site's information architecture,
+// navigation/footer visibility, route slugs, SEO copy, and editable
+// body blocks for pages such as home, about, blog, and privacy.
+
+import {
+  defaultPagesDataSourceEnv,
+  defaultSitePageFields,
+} from "@notionx/core/pages";
+
+export const pageFields = {
+  ...defaultSitePageFields,
+  blocks: "Blocks",
+} as const;
+
+export const pagesDataSourceEnv = defaultPagesDataSourceEnv;