This template includes a Angular app with a Sanity Studio – an open-source React application that connects to your Sanity project’s hosted dataset. The Studio is configured locally and can then be deployed for content collaboration.
- Fetch content seamlessly with Sanity Content Lake.
- Render beautiful block content using Portable Text.
- Manage and create content with the intuitive Sanity Studio.
- Advanced image cropping and rendering via Sanity Image URLs.
- Click-to-edit overlays and live preview in the Presentation tool via
@sanity/visual-editing-standalone.
https://sanity-template-angular-clean.sanity.build
Run the command in your Terminal to initialize this template on your local computer.
See the documentation if you are having issues with the CLI.
npm create sanity@latest -- --template sanity-io/sanity-template-angular-cleanCopy the project id and dataset from the generated .env file in the /studio directory to the Angular project's environment file.
Specifically:
- Open the
/studio/.envfile and note the values forSANITY_STUDIO_PROJECT_IDandSANITY_STUDIO_DATASET - Create or edit the
/angular-app/.envfile based on the.env.exampletemplate - Add the following lines with your values:
SANITY_PROJECT_ID="your-project-id"
SANITY_DATASET="your-dataset-name"
Navigate back to the template's root directory and start the development servers by running the following command
npm run devOpen the Angular app running locally in your browser on http://localhost:4200.
Open the Studio running locally in your browser on http://localhost:3333. You should now see a screen prompting you to log in to the Studio. Use the same service (Google, GitHub, or email) that you used when you logged in to the CLI.
The template comes pre-defined with a schema containing a Post document type.
From the Studio, click "+ Create" and select the Post document type. Go ahead and create and publish the document.
Your content should now appear in your Angular app (http://localhost:4200).
The schema for the Post document type is defined in the studio/src/schemaTypes/post.ts file. You can add more document types to the schema to suit your needs.
The Studio includes the Presentation tool, which shows the Angular app next to the document editor. When the app is loaded by Presentation and a viewer token is configured, it switches to preview mode:
- Content is fetched from the API (not the CDN) with the perspective selected in Presentation, which defaults to drafts. Strings are stega-encoded so overlays know which document and field they came from. Images get a
data-sanityattribute instead. src/app/visual-editing.tsenables the overlays with@sanity/visual-editing-standalone, keeps the Presentation URL bar in sync with the Angular router, and reloads content when you edit a document or press refresh in Presentation.
Anyone who opens the app outside Presentation, or uses a build without a token, gets the normal site: published content from the CDN, no overlays and no stega. The overlay code is only downloaded in preview mode.
-
Create a token with the Viewer role in Manage under API > Tokens, and add it to
/angular-app/.env:SANITY_API_READ_TOKEN="your-viewer-token" -
Allow the Angular app to send authenticated requests by adding its origin as a CORS origin with credentials. From the
/studiodirectory:npx sanity cors add http://localhost:4200 --credentials
-
Restart
npm run dev, open the Studio at http://localhost:3333 and select Presentation. Hover over a title, excerpt, body text or image and click it to open that field. Your edits show up in the preview as you type.
| Variable | Where | Description |
|---|---|---|
SANITY_API_READ_TOKEN |
/angular-app/.env |
Viewer token used to fetch drafts in preview mode. Leave it empty to turn Visual Editing off. |
SANITY_STUDIO_URL |
/angular-app/.env |
Studio URL that overlays open. Defaults to http://localhost:3333. |
SANITY_STUDIO_PREVIEW_URL |
/studio/.env |
URL of the Angular app shown in Presentation. Defaults to http://localhost:4200. |
The Angular app has no server, so the token is bundled into the browser JavaScript. Never set SANITY_API_READ_TOKEN on your public deployment. Instead, deploy a second copy of the app with the token, keep it private (for example behind your host's deployment protection), and add its origin to CORS with credentials. Then set SANITY_STUDIO_PREVIEW_URL in the Studio to that deployment, and SANITY_STUDIO_URL in the preview deployment to your deployed Studio.
Your Angular frontend (/angular-app) and Sanity Studio (/studio) are still only running on your local computer. It's time to deploy and get it into the hands of other content editors.
Back in your Studio directory (/studio), run the following command to deploy your Sanity Studio.
npx sanity deployYou have the freedom to deploy your Angular app to your hosting provider of choice. With Vercel and GitHub being a popular choice, we'll cover the basics of that approach.
- Create a GitHub repository from this project. Learn more.
- Create a new Vercel project and connect it to your Github repository.
- Set the
Root Directoryto your Angular app. - Configure your Environment Variables.
Now that you’ve deployed your Angular application and Sanity Studio, you can optionally invite a collaborator to your Studio. Open up Manage, select your project and click "Invite project members"
They will be able to access the deployed Studio, where you can collaborate together on creating content.