@janga/norna 0.7.5 → 0.7.6

package/docs/content.md

@@ -5,7 +5,7 @@ page metadata, section order, section ids, image rows, and Markdown text for
 the homepage.
 
 Route pages use the same page and section model in
-`site/routes/<route-folder>/route-content.md`. See [Routes](routes.md) for the
+`site/routes/<NNN-route-id>/route-content.md`. See [Routes](routes.md) for the
 route-specific rules.
 
 Site-wide visual defaults belong in [Theme](theme.md). Typography presets and
@@ -18,8 +18,6 @@ The Astro content schema validates these top-level fields in page files:
 
 - `title`: required string. Rendered as the document title.
 - `description`: required string. Rendered as the meta description.
-- `slug`: optional route URL slug. It is ignored on the homepage. If omitted on
-  a route page, the route folder name is used.
 - `navigation`: optional page navigation metadata. See [Routes](routes.md).
 - `presentation`: optional page-level presentation overrides. See
   [Theme](theme.md) and [Typography](typography.md).
@@ -101,7 +99,7 @@ Image rows support:
 
 Source image filenames must be unique across the selected page's image tree.
 The homepage reads images from `site/images/<section-id>/`. Route pages read
-images from `site/routes/<route-folder>/images/<section-id>/`.
+images from `site/routes/<NNN-route-id>/images/<section-id>/`.
 
 ## Carousels
 
@@ -206,7 +204,7 @@ presentation:
         paragraphSpacing: 0.8em
 ```
 
-Top-level page frontmatter may contain only `title`, `description`, `slug`,
+Top-level page frontmatter may contain only `title`, `description`,
 `navigation`, `presentation`, `frame`, and `sections`. A `gallery` key belongs
 under one `sections[]` item:
 

package/docs/engine-development.md

@@ -160,7 +160,7 @@ and commit their updated `package-lock.json`.
 ## Rendering Notes
 
 The renderer builds the homepage at `/` and optional first-level routes from
-`site/routes/<route-folder>/route-content.md`.
+`site/routes/<NNN-route-id>/route-content.md`.
 
 Navigation has two separate levels:
 

package/docs/getting-started.md

@@ -71,7 +71,8 @@ Commit the generated `package-lock.json` after the first install.
    image rows, page/section presentation overrides, alt text, and captions.
 4. Put source images under `site/images/<section-id>/`.
 5. Add optional route pages under
-   `site/routes/<route-folder>/route-content.md`.
+   `site/routes/<NNN-route-id>/route-content.md`, for example
+   `site/routes/010-about/route-content.md`.
 6. Put static files such as `robots.txt`, `CNAME`, and favicons under
    `site/public/`.
 7. Run:

package/docs/routes.md

@@ -1,19 +1,56 @@
 # Routes
 
 `site/content.md` is the homepage and builds to `/`. Optional route pages live
-under `site/routes/<route-folder>/route-content.md` and build to first-level
+under `site/routes/<NNN-route-id>/route-content.md` and build to first-level
 URLs.
 
 Routes use the same page frontmatter, section frontmatter, image rows, and
 Markdown section model as the homepage. See [Content](content.md) for the page
 and section model.
 
+## Route Directory Format
+
+Route directories must use:
+
+```text
+NNN-route-id
+```
+
+`NNN` is a three-digit presentation order from `001` through `999`.
+`route-id` becomes the route identity and URL segment.
+
+Valid examples:
+
+```text
+010-getting-started
+020-concepts
+120-api-reference
+```
+
+Invalid examples:
+
+```text
+10-about
+000-home
+010_About
+010-About
+010-about-
+010-about--team
+```
+
+The route id may contain only lowercase `a-z`, numbers, and single hyphens
+between alphanumeric groups. The numeric prefix is not part of the route id or
+URL.
+
+Renaming `030-contact/` to `015-contact/` changes navigation order but keeps
+the route id `contact` and URL `/contact/`.
+
 ## Route File
 
 Add a first-level route by creating:
 
 ```text
-site/routes/about/route-content.md
+site/routes/010-about/route-content.md
 ```
 
 Minimal route page:
@@ -24,7 +61,6 @@ title: About
 description: About this site.
 navigation:
   label: About
-  order: 20
 sections:
   - id: intro
 ---
@@ -36,28 +72,14 @@ Text...
 
 The example above builds to `/about/`.
 
-## Slug
-
-If `slug` is omitted, the route folder name is used. If `slug` is set, it must
-use lowercase letters, numbers, and hyphens.
-
-```yaml
-slug: about-the-work
-```
-
-Keep the route folder and `slug` aligned unless you intentionally need a
-different URL.
-
-The homepage ignores `slug`.
-
 ## Navigation
 
 `navigation` may contain:
 
 - `include`: optional boolean. Defaults to `true`.
 - `label`: optional string. Defaults to `title`.
-- `order`: optional integer. Defaults to `0` for the homepage and `100` for
-  route pages.
+
+Route order comes from the directory prefix. The homepage is always first.
 
 Current route navigation is intended for small sites. This guidance may change
 as route support matures, but the present model is:
@@ -71,10 +93,10 @@ as route support matures, but the present model is:
 
 ## Route Images
 
-Route images live under the route:
+Route images live under the physical route directory:
 
 ```text
-site/routes/about/images/intro/image.jpg
+site/routes/010-about/images/intro/image.jpg
 ```
 
 Image references in route frontmatter still use only the filename:

package/docs/site-structure.md

@@ -15,7 +15,7 @@ site/
 |-- images/
 |   `-- <section-id>/
 |-- routes/
-|   `-- <route-folder>/
+|   `-- <NNN-route-id>/
 |       |-- route-content.md
 |       `-- images/
 |           `-- <section-id>/
@@ -44,9 +44,9 @@ Version these files in a site repository:
 - `site/content.md`: homepage page file with editable content, section
   definitions, image rows, alt text, and captions. See [Content](content.md).
 - `site/images/<section-id>/`: original source images.
-- `site/routes/<route-folder>/route-content.md`: optional route page files.
+- `site/routes/<NNN-route-id>/route-content.md`: optional route page files.
   See [Routes](routes.md).
-- `site/routes/<route-folder>/images/<section-id>/`: original source images
+- `site/routes/<NNN-route-id>/images/<section-id>/`: original source images
   for that route page.
 - `site/public/`: site-specific static public files.
 - `site/.norna/generated-images.json`: generated image manifest used to

package/examples/dog-gallery/site/content.md

@@ -3,7 +3,6 @@ title: Local Dog Example
 description: A small norna example with free dog images.
 navigation:
   label: Dog site!
-  order: 10
 sections:
   - id: black-dogs
     presentation:

package/examples/dog-gallery/site/routes/{dog-care → 010-dog-care}/route-content.md

@@ -3,7 +3,6 @@ title: Dog care
 description: A small route for testing multi-page norna navigation.
 navigation:
   label: Dog care
-  order: 20
 sections:
   - id: daily-rhythm
     presentation:

package/package.json

@@ -2,7 +2,7 @@
   "name": "@janga/norna",
   "description": "A command-line publishing workflow for simple static sites.",
   "type": "module",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
@@ -62,8 +62,9 @@
     "deploy:watch": "node bin/norna.mjs deploy:watch",
     "doctor": "node bin/norna.mjs doctor",
     "demo:build": "node bin/norna.mjs --site-dir examples/dog-gallery/site build",
-    "test": "npm run test:content-check && npm run test:site-public && npm run test:cli-discovery && npm run test:engine-commands && npm run test:ci-lockfile && npm run test:temporary-visibility && npm run test:fixture:build && npm run package:check",
+    "test": "npm run test:route-model && npm run test:content-check && npm run test:site-public && npm run test:cli-discovery && npm run test:engine-commands && npm run test:ci-lockfile && npm run test:temporary-visibility && npm run test:fixture:build && npm run package:check",
     "test:fixture:build": "node bin/norna.mjs --site-dir fixtures/basic/site build",
+    "test:route-model": "node scripts/test-route-model.mjs",
     "test:content-check": "node scripts/test-content-check.mjs",
     "test:site-public": "node scripts/test-site-public.mjs",
     "test:cli-discovery": "node scripts/test-cli-discovery.mjs",

package/scripts/deploy-site.mjs

@@ -206,7 +206,7 @@ const assertDeployableStatus = async (entries, expectedImagePaths) => {
 	if (unexpectedUntracked.length > 0) {
 		fail([
 			'Refusing to deploy: unexpected untracked files are present.',
-			`Only new referenced images under ${siteImagesLabel}/<section-id>/ or ${siteRoutesLabel}/<route-folder>/images/<section-id>/ are staged automatically.`,
+			`Only new referenced images under ${siteImagesLabel}/<section-id>/ or ${siteRoutesLabel}/<NNN-route-id>/images/<section-id>/ are staged automatically.`,
 			...unexpectedUntracked.map((entry) => `- ${formatEntry(entry)}`),
 		].join('\n'));
 	}

package/scripts/lib/route-model.mjs

@@ -0,0 +1,17 @@
+export const routeDirectoryPattern = /^(?!000)(\d{3})-([a-z0-9]+(?:-[a-z0-9]+)*)$/;
+
+export const parseRouteDirectory = (routeDirectory, label = 'route directory') => {
+	const match = routeDirectory.match(routeDirectoryPattern);
+
+	if (!match) {
+		throw new Error(
+			`Invalid ${label} "${routeDirectory}". Route directories must use the form NNN-route-id, for example 010-getting-started. The prefix must be 001-999 and route-id may contain only lowercase letters, numbers, and single hyphens.`,
+		);
+	}
+
+	return {
+		routeDirectory,
+		routeOrder: Number.parseInt(match[1], 10),
+		routeId: match[2],
+	};
+};

package/scripts/lib/site-content.mjs

@@ -10,6 +10,7 @@ import {
 	siteRoutesLabel,
 	siteThemeLabel,
 } from './site-paths.mjs';
+import { parseRouteDirectory } from './route-model.mjs';
 
 export const supportedImageExtensions = new Set(['.jpg', '.jpeg', '.png']);
 
@@ -17,7 +18,7 @@ const h2Regex = /^##\s+.*$/gm;
 const explicitHeadingIdRegex = /\s*\{#([a-z0-9-]+)\}\s*$/;
 const inlineStyleReferenceRegex = /\[[^\]\n]+\]\{\.([a-z][a-z0-9-]*)\}/g;
 const frontmatterDelimiterRegex = /^---\s*$/;
-const knownContentTopLevelFrontmatterKeys = new Set(['title', 'description', 'slug', 'navigation', 'presentation', 'frame', 'sections']);
+const knownContentTopLevelFrontmatterKeys = new Set(['title', 'description', 'navigation', 'presentation', 'frame', 'sections']);
 const knownThemeTopLevelFrontmatterKeys = new Set(['navigation', 'layout', 'gallery', 'typography', 'presentation', 'frame']);
 const knownNestedFrontmatterKeys = new Set([
 	'align',
@@ -55,7 +56,6 @@ const knownNestedFrontmatterKeys = new Set([
 	'mobile',
 	'navigation',
 	'overrides',
-	'order',
 	'paragraphSpacing',
 	'pageWidth',
 	'preset',
@@ -85,7 +85,9 @@ export const getContentFiles = async () => {
 		imagesDir: siteImagesDir,
 		imagesLabel: siteImagesLabel,
 		isHome: true,
-		routeFolder: null,
+		routeDirectory: null,
+		routeId: null,
+		routeOrder: 0,
 	}];
 	const routeEntries = await readdir(siteRoutesDir, { withFileTypes: true }).catch((error) => {
 		if (error?.code === 'ENOENT') {
@@ -98,19 +100,23 @@ export const getContentFiles = async () => {
 	for (const entry of routeEntries) {
 		if (!entry.isDirectory()) continue;
 
-		const routeFolder = entry.name;
-		const routeDir = path.join(siteRoutesDir, routeFolder);
+		const routeDirectory = entry.name;
+		const routeDir = path.join(siteRoutesDir, routeDirectory);
 		const routeContentPath = path.join(routeDir, 'route-content.md');
 
 		if (!(await fileExists(routeContentPath))) continue;
 
+		const { routeId, routeOrder } = parseRouteDirectory(routeDirectory, `${siteRoutesLabel}/${routeDirectory}`);
+
 		contentFiles.push({
-			contentLabel: `${siteRoutesLabel}/${routeFolder}/route-content.md`,
+			contentLabel: `${siteRoutesLabel}/${routeDirectory}/route-content.md`,
 			contentPath: routeContentPath,
 			imagesDir: path.join(routeDir, 'images'),
-			imagesLabel: `${siteRoutesLabel}/${routeFolder}/images`,
+			imagesLabel: `${siteRoutesLabel}/${routeDirectory}/images`,
 			isHome: false,
-			routeFolder,
+			routeDirectory,
+			routeId,
+			routeOrder,
 		});
 	}
 

package/scripts/show-typography.mjs

@@ -359,7 +359,7 @@ const readPageTypography = async (contentFile, themeTypography) => {
 
 	return {
 		source: contentFile.contentLabel,
-		route: contentFile.isHome ? '/' : `/${contentFile.routeFolder}/`,
+		route: contentFile.isHome ? '/' : `/${contentFile.routeId}/`,
 		pageTypography,
 		sections,
 	};

package/scripts/sync-content-sections.mjs

@@ -164,9 +164,6 @@ const warnAboutCarouselAspectRatios = async () => {
 	}
 };
 
-const getFrontmatterSlug = (frontmatter) =>
-	frontmatter.match(/^slug:\s*["']?([^"'\n]+)["']?\s*$/m)?.[1]?.trim() ?? null;
-
 const validateRouteContentFiles = async () => {
 	const routeContentFiles = (await getContentFiles()).filter((contentFile) => !contentFile.isHome);
 
@@ -175,15 +172,6 @@ const validateRouteContentFiles = async () => {
 		validateFrontmatterIndentation(routeFrontmatter, addIssue);
 		validateContentFrontmatterStructure(routeFrontmatter, addIssue);
 
-		const slug = getFrontmatterSlug(routeFrontmatter);
-		if (slug && slug !== contentFile.routeFolder) {
-			addIssue({
-				severity: 'warning',
-				message: `${contentFile.contentLabel} has slug "${slug}" but its route folder is "${contentFile.routeFolder}".`,
-				fix: `Keep slug and route folder aligned unless the page intentionally needs to build at /${slug}/.`,
-			});
-		}
-
 		const routeFrontmatterSections = getFrontmatterSections(routeFrontmatter);
 		const routeFrontmatterIds = routeFrontmatterSections.map((section) => section.id);
 		const routeBodySections = getBodySections(routeBody).sections;

package/scripts/test-package-check.mjs

@@ -190,13 +190,12 @@ try {
 		packageCheckThemePath,
 		packageCheckTheme.replace('brand: Example Site', 'brand: Package Check Brand'),
 	);
-	await mkdir(path.join(siteProjectRoot, 'site', 'routes', 'about'), { recursive: true });
-	await writeFile(path.join(siteProjectRoot, 'site', 'routes', 'about', 'route-content.md'), `---
+	await mkdir(path.join(siteProjectRoot, 'site', 'routes', '010-about'), { recursive: true });
+	await writeFile(path.join(siteProjectRoot, 'site', 'routes', '010-about', 'route-content.md'), `---
 title: About the site
 description: Route used by package checks.
 navigation:
   label: About
-  order: 20
 sections:
   - id: about
 ---

package/scripts/test-route-model.mjs

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import { parseRouteDirectory } from './lib/route-model.mjs';
+
+assert.deepEqual(parseRouteDirectory('010-getting-started'), {
+	routeDirectory: '010-getting-started',
+	routeOrder: 10,
+	routeId: 'getting-started',
+});
+
+assert.deepEqual(parseRouteDirectory('120-api-reference'), {
+	routeDirectory: '120-api-reference',
+	routeOrder: 120,
+	routeId: 'api-reference',
+});
+
+for (const routeDirectory of [
+	'000-home',
+	'10-about',
+	'010_About',
+	'010-About',
+	'010-about-',
+	'010-about--team',
+	'010-om-oss!',
+]) {
+	assert.throws(
+		() => parseRouteDirectory(routeDirectory),
+		/Route directories must use the form NNN-route-id/,
+		`${routeDirectory} should be rejected`,
+	);
+}
+
+console.log('Route model test passed.');

package/src/components/SitePage.astro

@@ -16,13 +16,12 @@ interface Props {
 
 const { entry } = Astro.props;
 const siteDirectory = (process.env.NORNA_SITE_DIR ?? 'site').trim();
+const sitePages = getSitePages(await getCollection('site'));
+const currentPage = getSitePage(entry);
 const siteContentLabel = entry.id.includes('-route-')
-	? `${siteDirectory || 'site'}/routes/${entry.id.split('-route-').at(-1)}/route-content.md`
+	? `${siteDirectory || 'site'}/routes/${currentPage.routeDirectory}/route-content.md`
 	: `${siteDirectory || 'site'}/content.md`;
 const [theme] = await getCollection('theme');
-const allEntries = await getCollection('site');
-const sitePages = getSitePages(allEntries);
-const currentPage = getSitePage(entry);
 const navigationPages = getNavigationPages(sitePages);
 const homePage = sitePages.find((page) => page.isHome) ?? currentPage;
 const themeData = theme?.data ?? {};

package/src/content.config.ts

@@ -3,6 +3,7 @@ import { glob } from 'astro/loaders';
 import { pathToFileURL } from 'node:url';
 import { z } from 'astro/zod';
 import { siteDir, siteDirLabel } from '../scripts/lib/site-paths.mjs';
+import { parseRouteDirectory } from '../scripts/lib/route-model.mjs';
 import { isDateOnly } from './lib/visibility';
 
 const siteEntryId = `${siteDirLabel
@@ -10,7 +11,6 @@ const siteEntryId = `${siteDirLabel
 	.replace(/[^a-zA-Z0-9-]+/g, '-')
 	.replace(/^-+|-+$/g, '') || 'site'}-content`;
 const contentImageName = z.string().regex(/^[a-z0-9][a-z0-9.-]*\.(jpe?g|png)$/i);
-const routeSlug = z.string().regex(/^[a-z0-9][a-z0-9-]*$/, 'Use lowercase letters, numbers, and hyphens.');
 const colorValue = z.string().regex(
 	/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,
 	'Use a hex color such as "#000000".',
@@ -163,7 +163,6 @@ const frame = z.object({
 const pageNavigation = z.object({
 	include: z.boolean().optional(),
 	label: z.string().optional(),
-	order: z.number().int().optional(),
 }).strict();
 const themeNavigation = z.object({
 	brand: z.string().min(1).optional(),
@@ -182,7 +181,6 @@ const galleryItem = z.union([galleryImage, galleryCarousel]);
 const siteSchema = z.object({
 	title: z.string(),
 	description: z.string(),
-	slug: routeSlug.optional(),
 	navigation: pageNavigation.optional(),
 	presentation: pagePresentation.optional(),
 	frame: frame.optional(),
@@ -214,9 +212,9 @@ const site = defineCollection({
 				return siteEntryId;
 			}
 
-			const routeFolder = entry.match(/^routes\/([^/]+)\/route-content\.md$/)?.[1];
-			return routeFolder
-				? `${siteEntryId.replace(/-content$/, '')}-route-${routeFolder}`
+			const routeDirectory = entry.match(/^routes\/([^/]+)\/route-content\.md$/)?.[1];
+			return routeDirectory
+				? `${siteEntryId.replace(/-content$/, '')}-route-${parseRouteDirectory(routeDirectory, `route directory routes/${routeDirectory}`).routeDirectory}`
 				: entry.replace(/[^a-zA-Z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
 		},
 	}),

package/src/lib/sitePages.ts

@@ -1,4 +1,5 @@
 import type { CollectionEntry } from 'astro:content';
+import { parseRouteDirectory } from '../../scripts/lib/route-model.mjs';
 
 type SiteEntry = CollectionEntry<'site'>;
 
@@ -10,9 +11,10 @@ export type SitePage = {
 		label: string;
 		order: number;
 	};
+	pathSegment: string;
 	pathname: string;
-	routeFolder: string | null;
-	slug: string;
+	routeDirectory: string | null;
+	routeId: string;
 	title: string;
 };
 
@@ -25,21 +27,21 @@ const stripRouteIdPrefix = (id: string) => {
 
 export const isHomePageEntry = (entry: SiteEntry) => stripRouteIdPrefix(entry.id) === null;
 
-const getRouteFolder = (entry: SiteEntry) => isHomePageEntry(entry) ? null : stripRouteIdPrefix(entry.id);
+const getRouteDirectory = (entry: SiteEntry) => isHomePageEntry(entry) ? null : stripRouteIdPrefix(entry.id);
 
-const getPageSlug = (entry: SiteEntry) => {
-	if (isHomePageEntry(entry)) return '';
-
-	const routeFolder = getRouteFolder(entry);
-	return entry.data.slug ?? routeFolder ?? '';
+const getRouteMetadata = (entry: SiteEntry) => {
+	const routeDirectory = getRouteDirectory(entry);
+	return routeDirectory ? parseRouteDirectory(routeDirectory, `route directory ${routeDirectory}`) : null;
 };
 
-const getPagePathname = (slug: string) => slug ? `/${slug}/` : '/';
+const getPagePathname = (pathSegment: string) => pathSegment ? `/${pathSegment}/` : '/';
 
 export const getSitePage = (entry: SiteEntry): SitePage => {
 	const isHome = isHomePageEntry(entry);
-	const routeFolder = getRouteFolder(entry);
-	const slug = getPageSlug(entry);
+	const routeMetadata = getRouteMetadata(entry);
+	const routeDirectory = routeMetadata?.routeDirectory ?? null;
+	const routeId = routeMetadata?.routeId ?? '';
+	const pathSegment = isHome ? '' : routeId;
 	const navigation = entry.data.navigation ?? {};
 
 	return {
@@ -48,11 +50,12 @@ export const getSitePage = (entry: SiteEntry): SitePage => {
 		navigation: {
 			include: navigation.include ?? true,
 			label: navigation.label ?? entry.data.title,
-			order: navigation.order ?? (isHome ? 0 : 100),
+			order: isHome ? 0 : routeMetadata?.routeOrder ?? 100,
 		},
-		pathname: getPagePathname(slug),
-		routeFolder,
-		slug,
+		pathSegment,
+		pathname: getPagePathname(pathSegment),
+		routeDirectory,
+		routeId,
 		title: entry.data.title,
 	};
 };
@@ -60,6 +63,8 @@ export const getSitePage = (entry: SiteEntry): SitePage => {
 export const getSitePages = (entries: SiteEntry[]) => {
 	const pages = entries.map(getSitePage);
 	const pathnames = new Map<string, SitePage>();
+	const routeIds = new Map<string, SitePage>();
+	const routeOrders = new Map<number, SitePage>();
 
 	for (const page of pages) {
 		const existing = pathnames.get(page.pathname);
@@ -68,6 +73,22 @@ export const getSitePages = (entries: SiteEntry[]) => {
 		}
 
 		pathnames.set(page.pathname, page);
+
+		if (page.isHome) continue;
+
+		const existingRouteId = routeIds.get(page.routeId);
+		if (existingRouteId) {
+			throw new Error(`Duplicate route id "${page.routeId}" from "${existingRouteId.entry.id}" and "${page.entry.id}".`);
+		}
+
+		routeIds.set(page.routeId, page);
+
+		const existingRouteOrder = routeOrders.get(page.navigation.order);
+		if (existingRouteOrder) {
+			throw new Error(`Duplicate route order "${String(page.navigation.order).padStart(3, '0')}" from "${existingRouteOrder.entry.id}" and "${page.entry.id}".`);
+		}
+
+		routeOrders.set(page.navigation.order, page);
 	}
 
 	return pages.sort((left, right) => (

package/src/pages/[slug].astro

@@ -10,7 +10,7 @@ export async function getStaticPaths() {
 	return pages
 		.filter((page) => !page.isHome)
 		.map((page) => ({
-			params: { slug: page.slug },
+			params: { slug: page.pathSegment },
 			props: { entry: page.entry },
 		}));
 }
@@ -23,8 +23,8 @@ if (!entry || isHomePageEntry(entry)) {
 
 const currentPage = getSitePage(entry);
 
-if (!currentPage.slug) {
-	throw new Error(`Route "${entry.id}" needs a slug or route folder name.`);
+if (!currentPage.pathSegment) {
+	throw new Error(`Route "${entry.id}" needs a route id.`);
 }
 ---
 

package/starters/project/README.md

@@ -24,7 +24,7 @@ npm run dev -- --kill
   density, typography rhythm, colors, frame colors, and inline text styles.
 - `site/content.md`: homepage title, sections, placeholders, project summary,
   links, install command, example usage, benefits, next steps, and license.
-- `site/routes/guide/route-content.md`: short secondary page with realistic
+- `site/routes/010-guide/route-content.md`: short secondary page with realistic
   project guide content.
 - `site/public/robots.txt`: static public file copied into the built site.
 
@@ -36,7 +36,7 @@ GitHub Pages workflow uses `npm ci`.
 
 1. Replace the project name, tagline, links, install command, example usage,
    benefits, use cases, and license in `site/content.md`.
-2. Replace the guide examples in `site/routes/guide/route-content.md`, or
+2. Replace the guide examples in `site/routes/010-guide/route-content.md`, or
    delete the route if the homepage is enough.
 3. Edit `site/theme.md` for brand name, layout density, typography rhythm,
    colors, frame colors, and inline text styles.

package/starters/project/site/content.md

@@ -3,7 +3,6 @@ title: Your project
 description: A compact project site starter for an open source developer tool.
 navigation:
   label: Home
-  order: 0
 sections:
   - id: intro
   - id: links

package/starters/project/site/routes/{guide → 010-guide}/route-content.md

@@ -3,7 +3,6 @@ title: Guide
 description: Adapt this compact guide for normal project use.
 navigation:
   label: Guide
-  order: 10
 sections:
   - id: quickstart
   - id: configuration