CMS Template Documentation

1. Installation

1. Download the template: After purchase, download the ZIP file and extract it to your workspace.
2. Install dependencies:

   npm install

3. Set up environment variables: Copy .env.example to .env and fill in your Sanity project details.

   cp .env.example .env

   • SANITY_PROJECT_ID – Your Sanity project ID
   • SANITY_DATASET – Your Sanity dataset name
   • SANITY_API_TOKEN – Your Sanity API token (if needed for write access)
4. Start the development server:

   npm run dev

   Your app will be running at http://localhost:3000.
5. Set up Sanity Studio (optional): If your template includes a Sanity Studio, navigate to the /studio folder and run:

   npm install && npm run dev

   This will start the Sanity Studio for content management.

2. Customization

• Edit content: Manage your site’s content in Sanity Studio. Changes will be reflected instantly in your Next.js app.
• Edit pages and components: Modify files in the /app and /components directories to update layout, styles, and structure.
• Change styles: Update Tailwind CSS classes directly in your JSX. You can also edit tailwind.config.js to customize your color palette, fonts, and breakpoints.
• Use shadcn/ui components: All UI elements use shadcn/ui. You can add new components by running:

  npx shadcn-ui@latest add [component]

  Replace [component] with the desired UI element (e.g., button, card).
• Update metadata: Edit app/layout.tsx and page-level metadata for SEO and social sharing.

3. Deployment

• Build your app:

  npm run build

• Deploy to your preferred platform: You can deploy to platforms like Netlify, AWS Amplify, Render, or your own server. Make sure to set NODE_ENV=production and run npm run build before serving.
• Set environment variables: Ensure your production environment has all required variables from .env.
• Deploy Sanity Studio (optional): You can deploy your Sanity Studio separately using Sanity’s deployment guides.

Troubleshooting & Tips

• If you see build errors, check your Node.js version (Next.js 15 requires Node 18+).
• For Sanity integration issues, see the Sanity docs.
• For shadcn/ui issues, refer to the official documentation.
• For Tailwind CSS customization, see the Tailwind docs.