Skip to content

Latest commit

 

History

History
99 lines (63 loc) · 2.45 KB

README.md

File metadata and controls

99 lines (63 loc) · 2.45 KB

Sanity Template Kit

A minimal scaffolding template for creating your own Sanity template. Intended for template creators — customize as needed!

Folder Structure

├── frontend/          # Your frontend application
├── studio/            # Sanity Studio
└── package.json       # Root workspace configuration

Getting Started

A more in-depth guide is available in the Sanity documentation. Need inspiration or help creating a template? Join the #template-creators channel in Sanity’s Slack community to connect with others and get feedback.

Clone the Repository

Clone the template repository to your local machine.

Install Dependencies

npm install

Add a Frontend Framework

Install your preferred frontend framework. The command below installs a new Next.js project in the frontend directory.

npx create-next-app@latest frontend

Customize Frontend Package

The frontend package is already defined as a workspace in the root package.json, but you may need to customize as needed.

Configure Environment Variables

Create an .env.example file in your frontend directory with the following variables:

SANITY_PROJECT_ID=
SANITY_DATASET=

For Next.js projects, prefix the variables with NEXT_PUBLIC_:

NEXT_PUBLIC_SANITY_PROJECT_ID=
NEXT_PUBLIC_SANITY_DATASET=

Run the app

npm run dev

Deployment

Deploy Studio

To deploy your Sanity Studio to production:

  1. Make sure you're logged in to your Sanity account:
npx sanity login
  1. Deploy the studio:
npm run deploy:studio

Deploy Frontend

You have the freedom to deploy your app to your hosting provider of choice. With Vercel and GitHub being a popular choice, we'll cover the basics of that approach:

  1. Create a GitHub repository from this project. Learn more.
  2. Create a new Vercel project and connect it to your Github repository.
  3. Set the Root Directory to your frontend directory.
  4. Configure your Environment Variables.

Validate Template

npm run validate

This command ensures the Sanity CLI can properly read your template configuration.

More Info

For details on the template validator, visit sanity-io/template-validator.