nuotsu / sanitypress

Next.js + Sanity.io Stater Template with Tailwind CSS
https://sanitypress.dev
MIT License
36 stars 12 forks source link
nextjs sanity tailwindcss

SanityPress

An opinionated and minimally styled starter template with Tailwind CSS and pre-built schema and modules for rapid website development.

βš›οΈ Neutrino, πŸ”­ Umbra and πŸƒ Foliage themes now available as a bundle!

Visit here for more Studio screenshots.

Deploy with Vercel Deploy to Netlify

Table of Contents

Key Features

Getting Started

Directions are also found on the docs.

1. New repo

Clone, fork or use the template from the GitHub template.

2. Get a new Sanity project ID

From the Sanity.io Manage dashboard, create a new project from scratch (blank schema) with CLI.

3. Update environment variables

# /next/.env.local
NEXT_PUBLIC_BASE_URL = ...
NEXT_PUBLIC_SANITY_PROJECT_ID = ...
NEXT_PUBLIC_SANITY_TOKEN = ... # retrieve from https://sanity.io/manage
NEXT_PUBLIC_REVALIDATE = ... # number in seconds; leave empty for `revalidate: false`

# /sanity/.env.local
SANITY_STUDIO_PROJECT_ID = ...
SANITY_STUDIO_PREVIEW_URL = ... # your live or staging site URL

4. Populate the Studio with content

Open your new Sanity Studio and add (and publish):

  1. a Site document with a title field.
  2. a Page document with the slug index to use as the Home page.
  3. [Optional] a Page document with the slug 404 to use as the Page not found page.

5. Set up deployments

Update the Root Directory (Vercel) / Project Directory (Netlify) with a value of next. This tells the deployment service to serve the next/ directory and not the root.

Optionally, install either of the following plugins to add a widget to your Studio Dashboard:

# Vercel β€” https://www.sanity.io/plugins/vercel-dashboard-widget
npm i sanity-plugin-dashboard-widget-vercel

# Netlify β€” https://www.sanity.io/plugins/sanity-plugin-dashboard-widget-netlify
npm i sanity-plugin-dashboard-widget-netlify

6. Customize the frontend

Feel free to adjust styles, add more schema and modules, and more.

Staging

Create a new git branch (call it anythingβ€”e.g. staging or preview) and set an environment variable specific to that branch in your deployment service (Vercel or Netlify):

# Environment variable for the staging branch (in Vercel, Netlify, etc.)
ENABLE_PREVIEW = true

Now you can use the preview deployment URL to share staged content (unpublished changes) with your team or clients.

External References


Want to support future updates? Purchase a theme or buy me a coffee β˜•!