SkillsAdd

contentstack/kickstart-next · Archived

contentstack-kickstart

Contentstack Delivery SDK, live preview, getPage, env overrides, and content model alignment for kickstart-next.

First seen Jul 16, 2026

Installation

$ npx skills add contentstack/kickstart-next --skill contentstack-kickstart
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

typescript-style Same source · more installs
contentstack/kickstart-next

TypeScript compiler options, ESLint setup, and Contentstack entry typing conventions for kickst…

3 installs
dev-workflow Same source · more installs
contentstack/kickstart-next

Local setup, Contentstack seeding, env vars, CI expectations, and PR ownership for kickstart-ne…

3 installs
testing Same source
contentstack/kickstart-next

Test layout and policy for kickstart-next—currently no automated tests; credentials and CI cont…

2 installs
next-app Same source
contentstack/kickstart-next

App Router structure, React components, client vs server, and rendering patterns in kickstart-n…

2 installs

Also in this package

Other skills from contentstack/kickstart-next.

npx skills add contentstack/kickstart-next
typescript-style 3 dev-workflow 3 testing 2 next-app 2 framework 2 code-review 2

Browse all from contentstack/kickstart-next

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

Stars 2
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 3,036 B
  • docs SUMMARY.md 142 B

History

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

SKILL.md

Contentstack kickstart – kickstart-next

When to use

  • You are changing how the app talks to Contentstack (delivery, preview, regions, hosts).
  • You are extending or fixing assumptions about the page content type or Live Preview field bindings.

Instructions

Entry points

  • All stack configuration and fetching live in [lib/contentstack.ts](../../lib/contentstack.ts).
  • stack: created with contentstack.stack() from @contentstack/delivery-sdk, using API key, delivery token, environment, region, optional custom host, and live_preview options (preview token, preview host, enable flag).
  • initLivePreview(): calls ContentstackLivePreview.init() from @contentstack/live-preview-utils with ssr: false, mode: "builder", stack SDK/config, stack details, client URL params, and edit button settings.
  • getPage(url): queries the page content type, filters url with QueryOperation.EQUALS, and returns the first entry typed as Page from [lib/types.ts](../../lib/types.ts). When isPreview is true, adds editable tags via contentstack.Utils.addEditableTags().

Preview vs production routing

  • [app/page.tsx](../../app/page.tsx): if isPreview (NEXTPUBLICCONTENTSTACK_PREVIEW === "true"), render the client [components/Preview.tsx](../../components/Preview.tsx) with path="/"; otherwise fetch with getPage("/") on the server and render [components/Page.tsx](../../components/Page.tsx) (imported as Page).

Regions and endpoints

  • Region resolution uses getRegionForString from @timbenniks/contentstack-endpoints; getContentstackEndpoints(region, true) supplies default delivery, preview, and application hosts for that region.
  • If region resolution fails, the stack falls back to NEXTPUBLICCONTENTSTACK_REGION as passed through in code (typed loosely for internal flexibility).

Optional environment overrides (advanced)

  • Delivery host: NEXTPUBLICCONTENTSTACKCONTENTDELIVERY overrides the default from endpoints.
  • Preview host: NEXTPUBLICCONTENTSTACKPREVIEWHOST overrides preview URL host.
  • Application (Live Preview UI) host: NEXTPUBLICCONTENTSTACKCONTENTAPPLICATION overrides clientUrlParams.host in initLivePreview.
  • Image hostname for next/image: NEXTPUBLICCONTENTSTACKIMAGEHOSTNAME (see next.config.mjs).

Types and Live Preview attributes

  • Entry and field shapes for CSLP live in [lib/types.ts](../../lib/types.ts); $ on entries/fields holds data-cslp / parent attributes. Keep these aligned with modular blocks and page fields expected from the seeded stack.

Seed alignment

  • The app assumes a stack seeded from contentstack/kickstart-stack-seed (“Kickstart Stack”) and tokens/scopes described in [README.md](../../README.md). Changing content type UIDs or field UIDs requires matching code and type updates.