Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sitecore/jss
Software development kit for JavaScript developers building web applications with Sitecore Experience Platform
https://github.com/sitecore/jss
angular graphql headless-cms javascript nextjs react sitecore sitecore-jss ssr vue
Last synced: 6 days ago
JSON representation
Software development kit for JavaScript developers building web applications with Sitecore Experience Platform
- Host: GitHub
- URL: https://github.com/sitecore/jss
- Owner: Sitecore
- License: apache-2.0
- Created: 2017-09-20T15:27:36.000Z (over 7 years ago)
- Default Branch: dev
- Last Pushed: 2024-12-10T21:33:06.000Z (12 days ago)
- Last Synced: 2024-12-10T22:23:25.920Z (12 days ago)
- Topics: angular, graphql, headless-cms, javascript, nextjs, react, sitecore, sitecore-jss, ssr, vue
- Language: TypeScript
- Homepage: https://jss.sitecore.com
- Size: 259 MB
- Stars: 264
- Watchers: 32
- Forks: 275
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.MD
- Code of conduct: CODE_OF_CONDUCT.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# Sitecore JavaScript Rendering SDK (JSS)
[](https://dev.azure.com/sitecore-devex/headless-javascript/_build/latest?definitionId=8&branchName=dev) [](CONTRIBUTING.md)
This repository contains source code for all Sitecore JSS packages and templates to help you get started using Sitecore JSS.
## Getting started with JSS
To develop a JSS application, you need:
- An operating system supported by Node (Mac, Windows, Linux).
- Node. We recommend using the latest long-term support (LTS) release.
> To run a JSS application in production or develop using Sitecore data you need to connect your application to a Sitecore instance with the Headless Services module installed (requires a **Sitecore Headless Services license**). Sitecore _requires Windows_, but the Sitecore instance does not need to be local. You can use a Sitecore instance installed in a virtual machine or on a remote server.
### Identify the JSS version for your Sitecore version
JSS versions are coupled with Sitecore versions. The current JSS release is compatible with the latest version of Sitecore.
If you use an older version of Sitecore, before creating a JSS project, you need to determine which JSS version is compatible with your version of Sitecore XP.
To identify the correct JSS version for your Sitecore XP version:
- For Sitecore XP 7.5—9.3, in the [Sitecore modules compatibility table for Sitecore XP 7.5—9.3](https://support.sitecore.com/kb?id=kb_article_view&sysparm_article=KB0541788), in the section _Headless Services_, identify the correct JavaScript Services version for your Sitecore version.
- For Sitecore XP 10.0 and later, in the [Sitecore modules compatibility table for Sitecore XP 10.0 and later versions](https://support.sitecore.com/kb?id=kb_article_view&sysparm_article=KB1000576), in the section _Headless Services_, identify the correct JavaScript Services version for your Sitecore version.
### Getting started with the latest version of JSS
To create a JSS project:
1. In a terminal, run one of the following commands and follow the prompts:
```
npm init sitecore-jss
```
or
```
npx create-sitecore-jss
```
2. Change directory to your application folder:
```
cd my-first-jss-app
```
3. Start the development server:
```
jss start
```
### Working with older versions
If you need to use an older version of JSS, you must install the JSS CLI version 19.x or older.
To create a JSS project for an older version of JSS and Sitecore:
1. [Identify the correct JSS version for your Sitecore XP version](#identify-the-jss-version-for-your-sitecore-version).
2. Run the JSS CLI installation command:
```
npm i @sitecore-jss/sitecore-jss-cli@
```
Replace `` with your desired version. For example, `npm i @sitecore-jss/[email protected]`.
3. In a terminal, create your JSS project by running the following command:
```
jss create my-jss-app react --branch release/13.0.0
```
> The command uses the `--branch` option and you need to provide the name of a branch in the JSS repository. You can use a [release branch](https://github.com/Sitecore/jss/branches/all?query=release%2F) or any other branch from the repository.
4. Change directory to your application folder:
```
cd my-first-jss-app
```
5. Start the development server:
```
jss start
```
## Documentation and community resources
- Official JSS documentation:
- [XM Cloud](https://doc.sitecore.com/xmc/en/developers/jss/latest/jss-xmc/index-en.html)
- [XP](https://doc.sitecore.com/xp/en/developers/hd/latest/sitecore-headless-development/sitecore-javascript-rendering-sdks--jss-.html)
- [StackExchange](https://sitecore.stackexchange.com/)
- [Community Slack](https://sitecorechat.slack.com/messages/jss)
- [Sitecore Community Forum](https://community.sitecore.net/developers/f/40)
## Contributions
We are very grateful to the community for contributing bug fixes and improvements. We welcome all efforts to evolve and improve the Sitecore JavaScript Rendering SDK; read below to learn how to participate in those efforts.
### [Code of Conduct](CODE_OF_CONDUCT.md)
Sitecore has adopted a Code of Conduct that we expect project participants to adhere to. Please read [the full text](CODE_OF_CONDUCT.md) so that you can understand what actions will and will not be tolerated.
### [Contributing Guide](CONTRIBUTING.md)
Read our [contributing guide](CONTRIBUTING.md) to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes to React.
### License
Sitecore JavaScript Services is using the [Apache 2.0 license](LICENSE.MD).
## [Support](SUPPORT.md)