@contentful/create-studio-experiences 1.37.1-dev-20250425T1024-b8bfdfb.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Contentful
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @contentful/create-studio-experiences
+
+This package is a CLI tool to bootstrap a [React, Vite & TypeScript](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) app that renders [Studio Experiences](https://www.contentful.com/developers/docs/experiences/what-are-experiences/).
+
+## Prerequisites
+
+A Contentful Space that has Studio Experiences enabled. See: [How to enable Experiences in a space](https://www.contentful.com/help/enable-spaces-for-experiences/).
+
+## Getting started
+
+To create a Contentful Studio Experiences project, run this command and follow the prompts.
+
+```bash
+npm init @contentful/studio-experiences
+```
+
+Navigate to your project directory and start the server. After that, you can manage your Experiences in Contentful.
+
+```bash
+cd studio-experiences-react-app
+npm run dev
+```
+
+## Developing locally
+
+Run `npm run dev` to start the dev server that will watch and recompile the apps on changes.
+
+Once built, you can test the CLI locally by running `npm run create`, which will do the follow:
+
+- Copy the templates to the local folder
+- Run `node dist/index.js -d` to start the CLI in dev mode
+- Clean up the templates folder after the CLI has finished
+
+## CLI Steps
+
+1. Project Type
+2. React Type
+3. Installation Path - The generated project will be installed here.
+4. Connect to Contentful Space _(Optional)_ - Note: only spaces that have Studio Experiences enabled are eligible. See: [How to enable Experiences in a space](https://www.contentful.com/help/enable-spaces-for-experiences/).
+   - Select your Contentful Organization.
+   - Select your Contentful Space.
+   - Select your Environment (if your Space has multiple).
+   - Select or Create an API key.
+   - Content Type will be created for Experiences if needed.
+   - Demo Experience Entry will be created (unless one exists).
+   - Content Preview Settings will be configured if needed.
+5. Project Output - The React project will be created, incorporating the [Studio Experiences SDK](https://www.contentful.com/developers/docs/experiences/set-up-experiences-sdk/#usage).
+
+## CLI Options
+
+- Host - Specify the Contentful host. Defaults to `contentful.com`.
+  ```bash
+  node dist/index.js --host <my_host>
+  ```
+- Dev - Argument that is likely only applicable if you are actively developing this package. If `--dev` argument is passed, some basic cleanup operations will occur after the bulk of the executable has be run, namely the auth token will be revoked if it was generated by the CLI in that run. Additionally, the react project that was bootstrapped during execution will be deleted.
+  ```bash
+  node dist/index.js --dev
+  ```
+- Token - If you already have a valid API CLI token, you can optionally pass it as an argument. If you do not pass one, you will be prompted to create one at runtime.
+  ```bash
+  node dist/index.js --token <my_token>
+  ```

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const CONSTANTS: {
+    contentType: string;
+    environment: string;
+    locale: string;
+    slug: string;
+    title: string;
+};

package/dist/constants.js

@@ -0,0 +1,8 @@
+export const CONSTANTS = {
+    contentType: 'ExperiencesLayout',
+    environment: 'master',
+    locale: 'en-US',
+    slug: 'home-page',
+    title: 'Home Page',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;CACnB,CAAC"}