contentstack/kickstart-next-ssg · Archived

contentstack-kickstart

Contentstack Delivery SDK, environment variables, Live Preview, and the seeded page model in this kickstart.

First seen Jul 16, 2026

Installation

$ npx skills add contentstack/kickstart-next-ssg --skill contentstack-kickstart

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Also in this package

Other skills from contentstack/kickstart-next-ssg.

npx skills add contentstack/kickstart-next-ssg

Browse all from contentstack/kickstart-next-ssg

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,435 B
  • docs SUMMARY.md 138 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 2 installs

SKILL.md

Contentstack kickstart – kickstart-next-ssg

When to use

  • Changing how the app fetches or displays CMS content
  • Debugging Live Preview or Visual Builder integration
  • Extending TypeScript types for new fields or content types

Instructions

Entry points

  • Stack and helpers: [lib/contentstack.ts](../../lib/contentstack.ts) — stack, initLivePreview(), getPage(url)
  • CMS-aligned types: [lib/types.ts](../../lib/types.ts) — e.g. Page, Block, File

Stack configuration

  • Built with @contentstack/delivery-sdk contentstack.stack({ ... }) using NEXTPUBLICCONTENTSTACKAPIKEY, NEXTPUBLICCONTENTSTACKDELIVERYTOKEN, NEXTPUBLICCONTENTSTACK_ENVIRONMENT, and region-related settings.
  • Optional overrides for hosts/CDN (internal or custom): NEXTPUBLICCONTENTSTACKCONTENTDELIVERY, NEXTPUBLICCONTENTSTACKPREVIEWHOST, NEXTPUBLICCONTENTSTACKCONTENTAPPLICATION, NEXTPUBLICCONTENTSTACKPREVIEW (boolean string), NEXTPUBLICCONTENTSTACKPREVIEW_TOKEN.
  • Region resolution uses helpers from @timbenniks/contentstack-endpoints aligned with NEXTPUBLICCONTENTSTACK_REGION.

Fetching content

  • getPage(url) queries content type page, field url, equality match via QueryOperation.EQUALS, then returns the first entry.
  • When NEXTPUBLICCONTENTSTACK_PREVIEW === 'true', contentstack.Utils.addEditableTags is applied to the entry for in-editor overlays.

Live Preview (client)

  • [pages/index.tsx](../../pages/index.tsx): initLivePreview() runs in useEffect; ContentstackLivePreview.onEntryChange refetches the home page so the UI updates in preview.
  • initLivePreview in lib/contentstack.ts uses @contentstack/live-preview-utils with mode: "builder", stack details from env, optional application host from env/endpoints, and edit button enabled (with outsideLivePreviewPortal excluded).

Seeded stack and tokens

  • CLI seed and token setup are documented in root [README.md](../../README.md) (delivery token with preview scope, Live Preview environment).

Images and URLs

  • Remote image hostnames for next/image are configured in [next.config.mjs](../../next.config.mjs); optional NEXTPUBLICCONTENTSTACKIMAGEHOSTNAME narrows or replaces defaults.