Upgrade to Astro 4 and Sanity 3.46.0. Also included support for Visua…

…l Editing.

.env.example

@@ -1,3 +1,6 @@
 # Remember to add PUBLIC_ if generated by npx sanity init --env
 PUBLIC_SANITY_STUDIO_PROJECT_ID="r0z1eifg"
 PUBLIC_SANITY_STUDIO_DATASET="clean-dev"
+PUBLIC_SANITY_STUDIO_PREVIEW_URL="http://localhost:4321"
+SANITY_VISUAL_EDITING_ENABLED="true"
+SANITY_API_READ_TOKEN=""

README.md

@@ -11,7 +11,7 @@ This starter uses [Astro](https://astro.build/) for the front end and [Sanity](h
 
 ## Prerequisites
 
-- [Node.js](https://nodejs.org/en/) (v16.12 or later)
+- [Node.js](https://nodejs.org/en/) (v20.14 or later)
 
 ## Getting started
 
@@ -35,6 +35,24 @@ Your Astro app should now be running on [http://localhost:4321/](http://localhos
 
 The schema for the `Post` document is defined in the `/schema` folder. You can [add more document types](https://www.sanity.io/docs/schema-types) to the Studio to suit your needs.
 
+### Enabling Visual Editing
+
+Add the following variables to the .env file.
+
+- SANITY_VISUAL_EDITING_ENABLED="true"
+- SANITY_API_READ_TOKEN=""
+
+You'll notice that we rely on a "read token" which is required in order to enable stega encoding and for authentication when Sanity Studio is live previewing your application.
+
+1. Go to https://sanity.io/manage and select your project.
+2. Click on the 🔌 API tab.
+3. Click on + Add API token.
+4. Name it "SANITY_API_READ_TOKEN" and set Permissions to Viewer and hit Save.
+5. Copy the token and add it to your `.env` file: `SANITY_API_READ_TOKEN="<paste your token here>"`
+
+You can read more about Visual Editing (here)[https://www.sanity.io/docs/introduction-to-visual-editing].
+You can read more about the Astro integration (here)[https://github.com/sanity-io/sanity-astro?tab=readme-ov-file#enabling-visual-editing]
+
 ## Removing TypeScript
 
 If you do not wish to use TypeScript, we've included a `remove-typescript.mjs` file in the root of this repository. You can run this file with `node remove-typescript.mjs` to strip all types from this project. Please run this before tampering with any code to ensure that all types are properly removed.
@@ -43,7 +61,7 @@ If you intend to use TypeScript, you can safely remove the `remove-typescript.mj
 
 ## Removing the embedded Studio
 
-If you wish to manage and host the Studio separately, you remove the `studioBasePath` property for the `sanity` configuration in `astro.config.mjs`. You can also remove the following dependencies:
+If you wish to manage and host the Studio separately, you remove the `studioBasePath` and `stega` property for the `sanity` configuration in `astro.config.mjs`. You can also remove the following dependencies:
 
 - `output` in `astro.config.mjs`…
   - …and `adapter` in `astro.config.mjs`

astro.config.mjs

@@ -25,13 +25,18 @@ export default defineConfig({
   // Hybrid+adapter is required to support embedded Sanity Studio
   output: "hybrid",
   adapter: vercel(),
-  integrations: [sanity({
-    projectId,
-    dataset,
-    studioBasePath: "/admin",
-    useCdn: false,
-    // `false` if you want to ensure fresh data
-    apiVersion: "2023-03-20" // Set to date of setup to use the latest API version
-  }), react() // Required for Sanity Studio
-  ]
-});
+  integrations: [
+    sanity({
+      projectId,
+      dataset,
+      studioBasePath: "/admin",
+      stega: {
+        studioUrl: "/admin",
+      },
+      useCdn: false,
+      // `false` if you want to ensure fresh data
+      apiVersion: "2023-03-20", // Set to date of setup to use the latest API version
+    }),
+    react(), // Required for Sanity Studio
+  ],
+});

package.json

@@ -16,6 +16,7 @@
     "@sanity/astro": "^3.1.4",
     "@sanity/image-url": "1.0.2",
     "@sanity/vision": "3.48.1",
+    "@sanity/visual-editing": "^2.1.5",
     "@types/react": "18.3.3",
     "@types/react-dom": "18.3.0",
     "astro": "^4.11.3",

sanity.config.ts

@@ -6,10 +6,13 @@ const dataset =
   import.meta.env.PUBLIC_SANITY_STUDIO_DATASET! ||
   import.meta.env.PUBLIC_SANITY_DATASET!;
 
+const previewUrl =
+  import.meta.env.PUBLIC_SANITY_STUDIO_PREVIEW_URL || "http://localhost:4321";
+
 // Feel free to remove this check if you don't need it
-if (!projectId || !dataset) {
+if (!projectId || !dataset || !previewUrl) {
   throw new Error(
-    `Missing environment variable(s). Check if named correctly in .env file.\n\nShould be:\nPUBLIC_SANITY_STUDIO_PROJECT_ID=${projectId}\nPUBLIC_SANITY_STUDIO_DATASET=${dataset}\n\nAvailable environment variables:\n${JSON.stringify(
+    `Missing environment variable(s). Check if named correctly in .env file.\n\nShould be:\nPUBLIC_SANITY_STUDIO_PROJECT_ID=${projectId}\nPUBLIC_SANITY_STUDIO_DATASET=${dataset}\nPUBLIC_SANITY_STUDIO_PREVIEW_URL=${previewUrl}\n\nAvailable environment variables:\n${JSON.stringify(
       import.meta.env,
       null,
       2
@@ -19,6 +22,7 @@ if (!projectId || !dataset) {
 
 import { defineConfig } from "sanity";
 import { structureTool } from "sanity/structure";
+import { presentationTool } from "sanity/presentation";
 import { visionTool } from "@sanity/vision";
 import { schemaTypes } from "./schema";
 
@@ -27,7 +31,13 @@ export default defineConfig({
   title: "Project Name",
   projectId,
   dataset,
-  plugins: [structureTool(), visionTool()],
+  plugins: [
+    structureTool(),
+    presentationTool({
+      previewUrl,
+    }),
+    visionTool(),
+  ],
   schema: {
     types: schemaTypes,
   },