StudioCMS Beta.16 release docs

.gitignore

@@ -24,5 +24,9 @@ pnpm-debug.log*
 # TypeDoc documentation
 src/content/docs/en/typedoc/
 
+# Changelogs
+
+src/content/docs/en/guides/upgrade/release-notes.md
+
 # Eleventy cache
 .cache/

.vscode/settings.json

@@ -6,19 +6,24 @@
     "Coolify",
     "devapps",
     "foldertree",
+    "genpkey",
     "inox",
     "libsql",
     "lunariajs",
     "markdoc",
     "mergebot",
     "pagefind",
+    "pkey",
     "prototools",
+    "pubout",
     "seti",
     "shiki",
     "shikijs",
     "sponsorcolors",
+    "sqld",
     "studiocms",
     "turso",
+    "tursodatabase",
     "twoslash",
     "withstudiocms"
   ]

astro.config.mts

@@ -7,7 +7,7 @@ import starlightSidebarTopics from 'starlight-sidebar-topics';
 import getCoolifyURL from './hostUtils.ts';
 import rehypePlugins from './src/plugins/rehypePluginKit.ts';
 import { typeDocPlugins } from './typedoc.config.ts';
-import { getTranslations } from './starlight-sidebar/translate.ts';
+import { getTranslations } from './src/starlight-sidebar/translate.ts';
 import { devServerFileWatcher } from './src/integrations/dev-file-watcher.ts';
 import { remarkFallbackLang } from './src/plugins/remark-fallback-pages.ts';
 
@@ -20,7 +20,8 @@ const linkValidator = process.env.CHECK_LINKS
 				errorOnFallbackPages: false,
 				errorOnInconsistentLocale: true,
 				// Exclude TypeDoc paths as they contain auto-generated content with many internal links
-				exclude: ['/*/typedoc/**/*'],
+				// Exclude the dynamically generated latest guide redirect page
+				exclude: ['/*/typedoc/**/*', '/*/guides/upgrade/latest/'],
 			}),
 		]
 	: [];
@@ -59,7 +60,7 @@ export default defineConfig({
 			'./hostUtils.ts',
 			'./typedoc.config.ts',
 			'./starlight-types.ts',
-			'./starlight-sidebar/*',
+			'./src/starlight-sidebar/*',
 			'./src/content.ts',
 			'./src/share-link.ts',
 			'./src/util/*.ts',
@@ -89,14 +90,18 @@ export default defineConfig({
 			},
 			defaultLocale: 'en',
 			locales,
-			social: {
-				github: 'https://github.com/withstudiocms/studiocms',
-				discord: 'https://chat.studiocms.dev',
-				youtube: 'https://www.youtube.com/@StudioCMS',
-				'x.com': 'https://x.com/withstudiocms',
-				blueSky: 'https://bsky.app/profile/studiocms.dev',
-				openCollective: 'https://opencollective.com/StudioCMS',
-			},
+			social: [
+				{ label: 'GitHub', icon: 'github', href: 'https://github.com/withstudiocms/studiocms' },
+				{ label: 'Discord', icon: 'discord', href: 'https://chat.studiocms.dev' },
+				{ label: 'YouTube', icon: 'youtube', href: 'https://www.youtube.com/@StudioCMS' },
+				{ label: 'Twitter / X', icon: 'x.com', href: 'https://x.com/withstudiocms' },
+				{ label: 'BlueSky', icon: 'blueSky', href: 'https://bsky.app/profile/studiocms.dev' },
+				{
+					label: 'Open Collective',
+					icon: 'openCollective',
+					href: 'https://opencollective.com/StudioCMS',
+				},
+			],
 			customCss: [
 				'@studiocms/ui/css/global.css',
 				'./src/styles/sponsorcolors.css',
@@ -159,11 +164,6 @@ export default defineConfig({
 								translations: getTranslations('start-here'),
 								autogenerate: { directory: 'start-here' },
 							},
-							{
-								label: getTranslations('contributing').en,
-								translations: getTranslations('contributing'),
-								autogenerate: { directory: 'contributing' },
-							},
 							{
 								label: getTranslations('how-it-works').en,
 								translations: getTranslations('how-it-works'),
@@ -181,6 +181,52 @@ export default defineConfig({
 							},
 						],
 					},
+					{
+						label: getTranslations('topic-guides').en,
+						link: '/guides/',
+						icon: 'rocket',
+						id: 'guides',
+						badge: {
+							text: 'NEW',
+							variant: 'success',
+						},
+						items: [
+							{
+								label: getTranslations('contributing').en,
+								translations: getTranslations('contributing'),
+								autogenerate: { directory: 'guides/contributing' },
+							},
+							{
+								label: getTranslations('upgrade').en,
+								translations: getTranslations('upgrade'),
+								items: [
+									{
+										slug: 'guides/upgrade/release-notes',
+									},
+									{
+										label: getTranslations('latest').en,
+										translations: getTranslations('latest'),
+										link: 'guides/upgrade/latest',
+										badge: {
+											text: 'Link',
+											variant: 'note',
+										},
+									},
+									{
+										label: getTranslations('version').en,
+										translations: getTranslations('version'),
+										collapsed: true,
+										autogenerate: { directory: 'guides/upgrade/version-guides' },
+									},
+								],
+							},
+							{
+								label: getTranslations('database').en,
+								translations: getTranslations('database'),
+								autogenerate: { directory: 'guides/database' },
+							},
+						],
+					},
 					{
 						label: getTranslations('topic-package-catalog'),
 						link: '/package-catalog/',

hostUtils.ts

@@ -22,12 +22,12 @@ function splitListAndSelectFirst(list: string) {
 /**
  * Get the Domain of the Coolify URL from the coolify runtime environment
  *
- * Requires the COOLIFY_FQDN environment variable to be set as per the coolify docs:
+ * Requires the COOLIFY_URL environment variable to be set as per the coolify docs:
  *
  * @see https://coolify.io/docs/knowledge-base/environment-variables#predefined-variables
  */
 const getCoolifyURL = (returnHttps?: boolean) => {
-	const urlList = process.env.COOLIFY_DOMAIN_FQDN;
+	const urlList = process.env.COOLIFY_URL;
 	if (!urlList) {
 		return undefined;
 	}

knip.config.ts

@@ -6,6 +6,7 @@ const config: KnipConfig = {
 		'@studiocms/devapps',
 		'@studiocms/mdx',
 		'@studiocms/markdoc',
+		'@studiocms/wysiwyg',
 		'@astrojs/node',
 		'@astrojs/react',
 		'sharp',

lunaria.config.ts

@@ -127,8 +127,8 @@ export default defineConfig({
 			type: 'dictionary',
 		},
 		{
-			include: ['starlight-sidebar/*.json'],
-			pattern: 'starlight-sidebar/@lang.json',
+			include: ['src/starlight-sidebar/*.json'],
+			pattern: 'src/starlight-sidebar/@lang.json',
 			type: 'dictionary',
 		},
 		{

package.json

@@ -7,44 +7,46 @@
     "node": "20.14.0"
   },
   "scripts": {
-    "dev": "astro dev",
+    "dev": "pnpm gen-changelogs && astro dev",
     "start": "astro dev",
     "check": "astro check",
-    "build": "astro build",
+    "build": "pnpm gen-changelogs && astro build",
     "preview": "astro preview",
     "astro": "astro",
     "lunaria:build": "tsm --require=./scripts/filter-warnings.cjs ./scripts/lunaria.mts",
     "knip": "knip",
     "ci:install": "pnpm install --frozen-lockfile",
     "ci:build": "pnpm build",
     "ci:lunaria:build": "pnpm lunaria:build",
-    "ci:lunaria:report": "pnpm tsm --require=./scripts/filter-warnings.cjs ./scripts/lunaria-report-bot.ts"
+    "ci:lunaria:report": "pnpm tsm --require=./scripts/filter-warnings.cjs ./scripts/lunaria-report-bot.ts",
+    "gen-changelogs": "tsm --require=./scripts/filter-warnings.cjs ./scripts/generate-release-notes.ts"
   },
   "dependencies": {
-    "studiocms": "0.1.0-beta.13",
-    "@studiocms/blog": "0.1.0-beta.13",
-    "@studiocms/devapps": "0.1.0-beta.13",
+    "studiocms": "0.1.0-beta.16",
+    "@studiocms/blog": "0.1.0-beta.16",
+    "@studiocms/devapps": "0.1.0-beta.16",
     "@studiocms/ui": "^0.4.16",
-    "@studiocms/mdx": "0.1.0-beta.13",
-    "@studiocms/markdoc": "0.1.0-beta.13",
+    "@studiocms/mdx": "0.1.0-beta.16",
+    "@studiocms/markdoc": "0.1.0-beta.16",
+    "@studiocms/wysiwyg": "^0.1.0-experimental.3",
     "@actions/core": "^1.11.1",
-    "astro": "^5.5.4",
+    "astro": "^5.7.2",
     "@astrojs/check": "^0.9.4",
-    "@astrojs/starlight": "^0.32.4",
-    "@astrojs/db": "^0.14.8",
-    "@astrojs/node": "^9.1.3",
+    "@astrojs/starlight": "^0.34.0",
+    "@astrojs/db": "^0.14.11",
+    "@astrojs/node": "^9.2.0",
     "@astrojs/web-vitals": "^3.0.1",
-    "@astrojs/react": "^4.2.1",
+    "@astrojs/react": "^4.2.4",
     "sharp": "^0.33.5",
     "typescript": "^5.8.2",
     "astro-integration-kit": "^0.18.0",
     "knip": "^5.46.0",
     "tsm": "^2.3.0",
     "@biomejs/biome": "1.9.4",
     "@lunariajs/core": "https://pkg.pr.new/lunariajs/lunaria/@lunariajs/core@4c8b9b0",
-    "expressive-code-twoslash": "^0.4.0",
+    "expressive-code-twoslash": "^0.5.0",
     "@shikijs/colorized-brackets": "^3.2.1",
-    "starlight-package-managers": "^0.10.0",
+    "starlight-package-managers": "^0.11.0",
     "@11ty/eleventy-fetch": "^5.0.2",
     "starlight-sidebar-topics": "^0.6.0",
     "@types/hast": "^3.0.4",
@@ -55,7 +57,7 @@
     "typedoc-plugin-markdown": "^4.6.0",
     "typedoc-plugin-frontmatter": "^1.3.0",
     "typedoc-plugin-zod": "^1.4.0",
-    "starlight-image-zoom": "^0.11.1",
+    "starlight-image-zoom": "^0.12.0",
     "starlight-links-validator": "^0.16.0",
     "hastscript": "^9.0.1",
     "hast-util-to-string": "^3.0.1",
@@ -71,6 +73,11 @@
     "@docsearch/js": "^3.6.0",
     "fast-glob": "^3.3.3",
     "@types/mdast": "^4.0.4",
-    "unist-util-visit": "^5.0.0"
+    "unist-util-visit": "^5.0.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "mdast-util-from-markdown": "^2.0.2",
+    "mdast-util-to-string": "^4.0.0",
+    "semver": "^7.7.1",
+    "@types/semver": "^7.7.0"
   }
 }