.jpg?format=pjpg&auto=webp)
Get Started with JavaScript Delivery SDK and Live Preview
This guide will help you get started with Contentstack JavaScript Delivery SDK to build apps powered by Contentstack.
Prerequisites
To get started with JavaScript, you will need the following:
- NodeJS 4.4.7 or later
SDK Installation and Setup
To use the JavaScript Delivery SDK, download and include it in the script tag:
<script type="text/javascript" src="/path/to/contentstack.min.js"></script>
Initializing the Stack with Live Preview
Since the Live Preview Utils SDK is responsible for communication, you need to initialize it within your stack.
Use the following command to initialize the stack:
import Contentstack from 'contentstack'
const Stack = Contentstack.Stack({
api_key: 'api_key',
delivery_token: 'delivery_token',
environment: 'environment',
live_preview: {
management_token: management_token,
enable: true,
host: 'api.contentstack.io',
}
})
Note: By default, the host parameter points to the North America endpoint. If your website is hosted on the European data center, then pass the European endpoint against the host parameter.
For Server-side Rendered Websites
If you have a Server-side Rendered (SSR) website, use the following code to get the Live Preview hash key:
import express from 'express'
const app = express()
app.use((req, response, next) => {
// this will get live_preview hash and ContentType to request
Stack.livePreviewQuery(req.query)
next()
});
To install and initialize the Live Preview Utils SDK, you can refer to our SSR Live Preview Setup documentation.
For Client-side Rendered Websites
If your website is rendered on the client-side, you can refer to our CSR Live Preview Setup documentation.
Query Request
Contentstack SDKs let you interact with the Content Delivery APIs and retrieve content from Contentstack. They are read-only in nature. The SDKs fetch and deliver content from the nearest server via Fastly, our powerful and robust CDN.
To get an entry, you need to specify the content type UID and the UID of the entry.
Stack.ContentType('content_type_uid').Entry('entry_uid').fetch()
Stack.ContentType('content_type_uid').Query().find()
More Resources
More articles
