lightnet 3.9.1 → 3.10.1

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # lightnet
 
+## 3.10.1
+
+### Patch Changes
+
+- [#321](https://github.com/LightNetDev/LightNet/pull/321) [`87e0faf`](https://github.com/LightNetDev/LightNet/commit/87e0faf4ba7a6615d60e755385479092c5d2aa84) Thanks [@smn-cds](https://github.com/smn-cds)! - Update dependencies
+
+- [#321](https://github.com/LightNetDev/LightNet/pull/321) [`87e0faf`](https://github.com/LightNetDev/LightNet/commit/87e0faf4ba7a6615d60e755385479092c5d2aa84) Thanks [@smn-cds](https://github.com/smn-cds)! - Start implementing integrated experimental Admin UI.
+
+- [#321](https://github.com/LightNetDev/LightNet/pull/321) [`87e0faf`](https://github.com/LightNetDev/LightNet/commit/87e0faf4ba7a6615d60e755385479092c5d2aa84) Thanks [@smn-cds](https://github.com/smn-cds)! - Astro 5.14.8 resolves relative image paths like `image/my-image.jpg` without a `./` prefix, so remove the manual prefixing in `packages/lightnet/src/content/astro-image.ts`. See [Astro's release notes for version 5.14.8](https://github.com/withastro/astro/releases/tag/astro%405.14.8).
+
+- [#323](https://github.com/LightNetDev/LightNet/pull/323) [`a2e6980`](https://github.com/LightNetDev/LightNet/commit/a2e6980b2866795b1517dc7a916698f5d92231b1) Thanks [@smn-cds](https://github.com/smn-cds)! - Remove the unsupported `maxWidth` option from `MediaGallerySection` and `CategoriesSection`.
+
+  The option never worked correctly, but our docs previously only mentioned that in a note. Tighten the typings and runtime guardrails so that consumers see explicit feedback instead of misconfiguring the component.
+
+## 3.10.0
+
+### Minor Changes
+
+- [#315](https://github.com/LightNetDev/LightNet/pull/315) [`f01fd72`](https://github.com/LightNetDev/LightNet/commit/f01fd728efe1577248db40111b9dfe5bd1a33423) Thanks [@smn-cds](https://github.com/smn-cds)! - Add optional LightNet credits footer
+  - Adds `credits: boolean` to LightNet config to show a “Built with LightNet” footer; default is `false`
+  - Footer includes LightNet logo/text and appears when no `CustomFooter` is provided
+  - Adds i18n key `ln.footer.powered-by-lightnet` (English + AI generated translations provided)
+  - Enable via `astro.config.mjs`, lightnet config: `credits: true` (PR #315)
+
 ## 3.9.1
 
 ### Patch Changes

package/README.md

@@ -19,6 +19,10 @@ to see how it powers a live site.
 
 Take a look at the [LightNet developer docs](https://docs.lightnet.community).
 
+## 🛟 Getting support
+
+If you have questions about using LightNet or need guidance, visit [Getting support & getting involved](https://docs.lightnet.community/concepts/collaboration/#getting-support--getting-involved).
+
 ## 🤝 Contributing
 
 Got ideas or improvements? We’d love your help! [See the contribution guide](https://github.com/LightNetDev/lightnet/blob/main/CONTRIBUTING.md) to get started.

package/__e2e__/admin.spec.ts

@@ -0,0 +1,113 @@
+import { expect } from "@playwright/test"
+
+import { lightnetTest } from "./test-utils"
+
+const test = lightnetTest("./fixtures/basics/")
+
+test("Should not show `Edit` button on details page by default.", async ({
+  page,
+  startLightnet,
+}) => {
+  await startLightnet()
+
+  await page.getByRole("link", { name: "Faithful Freestyle" }).click()
+  await expect(
+    page.getByRole("heading", { name: "Faithful Freestyle" }),
+  ).toBeVisible()
+
+  const editButton = page.locator("#edit-btn")
+  await expect(editButton).toBeHidden()
+})
+
+test("Should show `Edit` button on book details page after visiting `/en/admin/` path.", async ({
+  page,
+  startLightnet,
+}) => {
+  const ln = await startLightnet()
+
+  await page.goto(ln.resolveURL("/en/admin/"))
+  await expect(
+    page.getByText("Admin features are enabled now.", { exact: true }),
+  ).toBeVisible()
+
+  await page.goto(ln.resolveURL("/en/media/faithful-freestyle--en"))
+  await expect(
+    page.getByRole("heading", { name: "Faithful Freestyle" }),
+  ).toBeVisible()
+
+  const editButton = page.locator("#edit-btn")
+  await expect(editButton).toBeVisible()
+  await expect(editButton).toHaveAttribute(
+    "href",
+    "/en/admin/media/faithful-freestyle--en",
+  )
+})
+
+test("Should show `Edit` button on video details page after visiting `/en/admin/` path.", async ({
+  page,
+  startLightnet,
+}) => {
+  const ln = await startLightnet()
+
+  await page.goto(ln.resolveURL("/en/admin/"))
+  await expect(
+    page.getByText("Admin features are enabled now.", { exact: true }),
+  ).toBeVisible()
+
+  await page.goto(ln.resolveURL("/en/media/how-to-kickflip--de"))
+  await expect(
+    page.getByRole("heading", { name: "Kickflip Anleitung" }),
+  ).toBeVisible()
+
+  const editButton = page.locator("#edit-btn")
+  await expect(editButton).toBeVisible()
+  await expect(editButton).toHaveAttribute(
+    "href",
+    "/en/admin/media/how-to-kickflip--de",
+  )
+})
+
+test("Should show `Edit` button on audio details page after visiting `/en/admin/` path.", async ({
+  page,
+  startLightnet,
+}) => {
+  const ln = await startLightnet()
+
+  await page.goto(ln.resolveURL("/en/admin/"))
+  await expect(
+    page.getByText("Admin features are enabled now.", { exact: true }),
+  ).toBeVisible()
+
+  await page.goto(ln.resolveURL("/en/media/skate-sounds--en"))
+  await expect(
+    page.getByRole("heading", { name: "Skate Sounds" }),
+  ).toBeVisible()
+
+  const editButton = page.locator("#edit-btn")
+  await expect(editButton).toBeVisible()
+  await expect(editButton).toHaveAttribute(
+    "href",
+    "/en/admin/media/skate-sounds--en",
+  )
+})
+
+test("Edit button on details page should navigate to media item edit page", async ({
+  page,
+  startLightnet,
+}) => {
+  const ln = await startLightnet()
+
+  await page.goto(ln.resolveURL("/en/admin/"))
+  await page.goto(ln.resolveURL("/en/media/faithful-freestyle--en"))
+
+  const editButton = page.locator("#edit-btn")
+  await expect(editButton).toBeVisible()
+
+  await editButton.click()
+  await expect(page).toHaveURL(
+    ln.resolveURL("/en/admin/media/faithful-freestyle--en"),
+  )
+  await expect(
+    page.getByText("Edit media item", { exact: false }),
+  ).toBeVisible()
+})

package/__e2e__/fixtures/basics/astro.config.mjs

@@ -9,6 +9,7 @@ export default defineConfig({
     lightnet({
       title: "Basic Test",
       logo: { src: "./src/assets/logo.png" },
+      credits: true,
       languages: [
         {
           code: "en",
@@ -29,6 +30,11 @@ export default defineConfig({
         },
         { href: "/media", label: "ln.search.title" },
       ],
+      experimental: {
+        admin: {
+          enabled: true,
+        },
+      },
     }),
   ],
 })

package/__e2e__/fixtures/basics/node_modules/.bin/astro

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.13.3_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.48.1_terser@5.39.0_typescript@5.9.2_yaml@2.8.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.13.3_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.48.1_terser@5.39.0_typescript@5.9.2_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.14.8_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.52.5_terser@5.39.0_typescript@5.9.3_yaml@2.8.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.14.8_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.52.5_terser@5.39.0_typescript@5.9.3_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.13.3_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.48.1_terser@5.39.0_typescript@5.9.2_yaml@2.8.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.13.3_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.48.1_terser@5.39.0_typescript@5.9.2_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.14.8_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.52.5_terser@5.39.0_typescript@5.9.3_yaml@2.8.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.14.8_@types+node@24.3.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.52.5_terser@5.39.0_typescript@5.9.3_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../astro/astro.js" "$@"

package/__e2e__/fixtures/basics/node_modules/.bin/tailwind

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../tailwindcss/lib/cli.js" "$@"

package/__e2e__/fixtures/basics/node_modules/.bin/tailwindcss

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.17/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/lib/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules/tailwindcss/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/tailwindcss@3.4.18_yaml@2.8.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../tailwindcss/lib/cli.js" "$@"

package/__e2e__/fixtures/basics/node_modules/.bin/tsc

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"

package/__e2e__/fixtures/basics/node_modules/.bin/tsserver

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.2/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"

package/__e2e__/fixtures/basics/package.json

@@ -4,16 +4,16 @@
   "version": "0.0.1",
   "private": "true",
   "dependencies": {
-    "@astrojs/react": "^4.3.0",
+    "@astrojs/react": "^4.4.0",
     "@astrojs/tailwind": "^6.0.2",
-    "@lightnet/decap-admin": "^3.1.2",
-    "astro": "^5.13.3",
-    "lightnet": "^3.9.0",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "sharp": "^0.34.3",
-    "tailwindcss": "^3.4.17",
-    "typescript": "^5.9.2"
+    "@lightnet/decap-admin": "^3.1.3",
+    "astro": "^5.14.8",
+    "lightnet": "^3.10.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "sharp": "^0.34.4",
+    "tailwindcss": "^3.4.18",
+    "typescript": "^5.9.3"
   },
   "engines": {
     "node": ">=22"

package/__e2e__/fixtures/basics/src/content/media/skate-sounds--en.json

@@ -0,0 +1,15 @@
+{
+  "commonId": "skate-sounds",
+  "title": "Skate Sounds",
+  "type": "audio",
+  "dateCreated": "2024-04-21",
+  "authors": ["Sk8 Ministries"],
+  "content": [
+    { "url": "/files/example-audio.mp3" },
+    { "url": "https://www.soundhelix.com/examples/mp3/SoundHelix-Song-2.mp3" }
+  ],
+  "image": "./images/cover.jpg",
+  "language": "en",
+  "categories": ["christian-living"],
+  "description": "A vibrant collection of authentic skate park sounds to energize your projects and playlists.\n\n**Highlights:**\n- Real-world skating ambience\n- Perfect for creative mixes\n- Inspiring background audio for worship gatherings"
+}

package/__e2e__/fixtures/basics/src/content/media-types/audio.json

@@ -0,0 +1,7 @@
+{
+  "label": "type.audio",
+  "detailsPage": {
+    "layout": "audio"
+  },
+  "icon": "mdi--music-box-outline"
+}

package/__e2e__/fixtures/basics/src/translations/de.yml

@@ -4,5 +4,6 @@ category.teens: Teens
 category.theology: Theologie
 type.book: Buch
 type.video: Video
+type.audio: Audio
 details.action.read: Lesen
 details.action.watch: Anschauen

package/__e2e__/fixtures/basics/src/translations/en.yml

@@ -4,5 +4,6 @@ category.teens: Teens
 category.theology: Theology
 type.book: Book
 type.video: Video
+type.audio: Audio
 details.action.read: Read
 details.action.watch: Watch

package/__e2e__/homepage.spec.ts

@@ -102,3 +102,24 @@ test("Should verify DE Detail media page url and title", async ({
   await expect(page.getByText("Sprache")).toBeVisible()
   await expect(page.getByText("Kategorie")).toBeVisible()
 })
+
+test("Should show `Powered by LightNet` in footer", async ({
+  page,
+  startLightnet,
+}) => {
+  await startLightnet()
+
+  const footerLink = page
+    .getByRole("contentinfo")
+    .getByRole("link", { name: /LightNet/ })
+
+  await expect(footerLink).toHaveText("Powered by LightNet")
+  await expect(footerLink).toHaveAttribute("href", "https://lightnet.community")
+
+  await page.getByLabel("Select language").click()
+  await page.getByRole("link", { name: "Deutsch" }).click()
+
+  await expect(
+    page.getByRole("contentinfo").getByRole("link", { name: /LightNet/ }),
+  ).toHaveText("Ermöglicht durch LightNet")
+})

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "lightnet",
+  "description": "LightNet makes it easy to run your own digital media library.",
   "type": "module",
   "license": "MIT",
-  "version": "3.9.1",
+  "version": "3.10.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/LightNetDev/lightnet",
@@ -30,8 +31,12 @@
     "./pages/RootRoute.astro": "./src/pages/RootRoute.astro",
     "./pages/SearchPageRoute.astro": "./src/pages/search-page/SearchPageRoute.astro",
     "./pages/DetailsPageRoute.astro": "./src/pages/details-page/DetailsPageRoute.astro",
-    "./pages/api/search.ts": "./src/pages/api/search.ts",
-    "./pages/api/versions.ts": "./src/pages/api/versions.ts"
+    "./api/internal/search.ts": "./src/pages/search-page/api/search.ts",
+    "./api/versions.ts": "./src/api/versions.ts",
+    "./api/media/[mediaId].ts": "./src/api/media/[mediaId].ts",
+    "./api/internal/fs/writeText.ts": "./src/admin/api/fs/writeText.ts",
+    "./admin/pages/AdminRoute.astro": "./src/admin/pages/AdminRoute.astro",
+    "./admin/pages/media/EditRoute.astro": "./src/admin/pages/media/EditRoute.astro"
   },
   "peerDependencies": {
     "astro": "^5.1.0",
@@ -40,25 +45,27 @@
     "tailwindcss": ">=3.4.0 <4.0.0"
   },
   "dependencies": {
-    "@astrojs/react": "^4.3.0",
+    "@astrojs/react": "^4.4.0",
     "@astrojs/tailwind": "^6.0.2",
     "@iconify-json/mdi": "^1.2.3",
     "@iconify/tailwind": "^1.2.0",
-    "@tailwindcss/typography": "^0.5.16",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tanstack/react-form": "^1.23.7",
+    "@tanstack/react-query": "^5.90.5",
     "@tanstack/react-virtual": "^3.13.12",
     "daisyui": "^4.12.24",
     "embla-carousel": "^8.6.0",
     "embla-carousel-wheel-gestures": "^8.1.0",
     "fuse.js": "^7.1.0",
-    "i18next": "^25.4.2",
-    "marked": "^16.2.0",
+    "i18next": "^25.6.0",
+    "marked": "^16.4.1",
     "yaml": "^2.8.1"
   },
   "devDependencies": {
-    "@playwright/test": "^1.55.0",
-    "@types/node": "^22.18.0",
-    "@types/react": "^19.1.11",
-    "typescript": "^5.9.2",
+    "@playwright/test": "^1.56.1",
+    "@types/node": "^22.18.12",
+    "@types/react": "^19.2.2",
+    "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   },
   "engines": {

package/src/admin/api/fs/writeText.ts

@@ -0,0 +1,50 @@
+import { mkdir, rename, rm, writeFile } from "node:fs/promises"
+import { dirname, isAbsolute, relative, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+import type { APIRoute } from "astro"
+import { root } from "astro:config/server"
+
+export const prerender = false
+
+export const POST: APIRoute = async ({ request }) => {
+  const rootDirPath = fileURLToPath(root)
+  const requestedPath = new URL(request.url).searchParams.get("path")
+  if (!requestedPath) {
+    throw new Error("'path' search param is undefined.")
+  }
+  if (isAbsolute(requestedPath)) {
+    throw new Error("Absolute paths are not allowed.")
+  }
+
+  const targetPath = resolve(rootDirPath, requestedPath)
+  const relativeToRoot = relative(rootDirPath, targetPath)
+  if (
+    relativeToRoot.startsWith("..") ||
+    relativeToRoot === "" ||
+    isAbsolute(relativeToRoot)
+  ) {
+    throw new Error("Path escapes project root.")
+  }
+
+  const targetDir = dirname(targetPath)
+  await mkdir(targetDir, { recursive: true })
+
+  const body = await request.text()
+  const timestamp = Date.now()
+  const tmpPath = `${targetPath}.tmp-${timestamp}`
+  try {
+    const tmpPath = `${targetPath}.tmp-${Date.now()}`
+    await writeFile(tmpPath, body, "utf-8")
+    await rename(tmpPath, targetPath)
+  } finally {
+    await rm(tmpPath, { force: true }).catch(() => {})
+  }
+
+  return new Response(JSON.stringify({ status: "ok" }), {
+    status: 200,
+    headers: {
+      "Content-Type": "application/json",
+    },
+  })
+}

package/src/admin/components/form/FieldErrors.tsx

@@ -0,0 +1,19 @@
+import type { AnyFieldMeta } from "@tanstack/react-form"
+
+type FieldErrorsProps = {
+  meta: AnyFieldMeta
+}
+
+export const FieldErrors = ({ meta }: FieldErrorsProps) => {
+  if (!meta.isTouched || meta.isValid) return null
+
+  return (
+    <ul className="my-2 flex flex-col gap-1" role="alert">
+      {meta.errors.map((error) => (
+        <li className="text-sm text-rose-800" key={error.code}>
+          {error.message}
+        </li>
+      ))}
+    </ul>
+  )
+}

package/src/admin/components/form/SubmitButton.tsx

@@ -0,0 +1,77 @@
+import { useStore } from "@tanstack/react-form"
+import { useEffect, useRef, useState } from "react"
+
+import Icon from "../../../components/Icon"
+import { useFormContext } from "./form-context"
+
+const SUCCESS_DURATION_MS = 2000
+
+const baseButtonClass =
+  "flex min-w-52 items-center justify-center gap-2 rounded-2xl px-6 py-3 font-bold uppercase shadow-sm transition-colors duration-200 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-gray-900 disabled:cursor-not-allowed"
+
+const buttonStateClasses = {
+  idle: "bg-gray-800 text-gray-100 hover:bg-gray-950 hover:text-gray-300 disabled:bg-gray-600 disabled:text-gray-200",
+  error:
+    "bg-rose-700 text-white hover:bg-rose-800 hover:text-white disabled:bg-rose-600",
+  success:
+    "bg-emerald-600 text-white hover:bg-emerald-700 hover:text-white disabled:bg-emerald-500",
+} as const
+
+const buttonLabels = {
+  idle: "Save",
+  success: "Saved",
+  error: "Failed",
+} as const
+
+const icons = {
+  idle: undefined,
+  success: "mdi--check",
+  error: "mdi--error-outline",
+} as const
+
+export default function SubmitButton() {
+  const form = useFormContext()
+  const { submissionAttempts, isSubmitting, isSubmitSuccessful } = useStore(
+    form.store,
+    (state) => ({
+      canSubmit: state.canSubmit,
+      isSubmitting: state.isSubmitting,
+      isSubmitSuccessful: state.isSubmitSuccessful,
+      submissionAttempts: state.submissionAttempts,
+    }),
+  )
+  const buttonState = useButtonState(isSubmitSuccessful, submissionAttempts)
+  const buttonClass = `${baseButtonClass} ${buttonStateClasses[buttonState]}`
+  const label = buttonLabels[buttonState]
+  const icon = icons[buttonState]
+
+  return (
+    <button className={buttonClass} type="submit" disabled={isSubmitting}>
+      {icon && <Icon className={icon} ariaLabel="" />}
+      {label}
+    </button>
+  )
+}
+
+function useButtonState(
+  isSubmitSuccessful: boolean,
+  submissionAttempts: number,
+) {
+  const [state, setState] = useState<"success" | "error" | "idle">("idle")
+  const timeoutRef = useRef<number | undefined>(undefined)
+  useEffect(() => {
+    if (submissionAttempts === 0) {
+      return
+    }
+    setState(isSubmitSuccessful ? "success" : "error")
+    if (timeoutRef.current !== undefined) {
+      window.clearTimeout(timeoutRef.current)
+    }
+    timeoutRef.current = window.setTimeout(() => {
+      setState("idle")
+      timeoutRef.current = undefined
+    }, SUCCESS_DURATION_MS)
+  }, [submissionAttempts, isSubmitSuccessful])
+
+  return state
+}

package/src/admin/components/form/TextField.tsx

@@ -0,0 +1,24 @@
+import { FieldErrors } from "./FieldErrors"
+import { useFieldContext } from "./form-context"
+
+export default function TextField({ label }: { label: string }) {
+  const field = useFieldContext<string>()
+  return (
+    <>
+      <label className="dy-form-control w-full max-w-sm">
+        <div className="dy-label">
+          <span className="dy-label-text">{label}</span>
+        </div>
+        <input
+          id={field.name}
+          name={field.name}
+          value={field.state.value}
+          onChange={(e) => field.handleChange(e.target.value)}
+          onBlur={field.handleBlur}
+          className={`dy-input dy-input-bordered dy-input-sm w-full max-w-sm ${field.state.meta.errors.length ? "dy-input-error" : ""}`}
+        />
+        <FieldErrors meta={field.state.meta} />
+      </label>
+    </>
+  )
+}

package/src/admin/components/form/form-context.ts

@@ -0,0 +1,4 @@
+import { createFormHookContexts } from "@tanstack/react-form"
+
+export const { fieldContext, useFieldContext, formContext, useFormContext } =
+  createFormHookContexts()

package/src/admin/components/form/index.ts

@@ -0,0 +1,16 @@
+import { createFormHook } from "@tanstack/react-form"
+
+import { fieldContext, formContext } from "./form-context"
+import SubmitButton from "./SubmitButton"
+import TextField from "./TextField"
+
+export const { useAppForm, withForm } = createFormHook({
+  fieldComponents: {
+    TextField,
+  },
+  formComponents: {
+    SubmitButton,
+  },
+  fieldContext,
+  formContext,
+})

package/src/admin/i18n/translations/en.yml

@@ -0,0 +1 @@
+ln.admin.edit: Edit

package/src/admin/i18n/translations.ts

@@ -0,0 +1,5 @@
+export const builtInAdminTranslations = {
+  en: () => import("./translations/en.yml?raw"),
+} as const
+
+export type AdminTranslationKey = "ln.admin.edit"

package/src/admin/pages/AdminRoute.astro

@@ -0,0 +1,16 @@
+---
+import Page from "../../layouts/Page.astro"
+
+export { getLocalePaths as getStaticPaths } from "../../i18n/get-locale-paths"
+---
+
+<Page>
+  <div
+    class="flex h-96 w-full items-center justify-center text-lg font-bold text-gray-500"
+  >
+    Admin features are enabled now.
+  </div>
+</Page>
+<script>
+  localStorage.setItem("ln-admin-enabled", "true")
+</script>