{"id":22542193,"url":"https://github.com/commercelayer/contentful-commerce","last_synced_at":"2026-02-27T01:02:31.786Z","repository":{"id":219305369,"uuid":"748587310","full_name":"commercelayer/contentful-commerce","owner":"commercelayer","description":"Contentful Commerce by Commerce Layer","archived":false,"fork":false,"pushed_at":"2024-09-04T10:51:53.000Z","size":2748,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-11T02:50:30.266Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/commercelayer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-26T10:12:00.000Z","updated_at":"2024-09-04T10:51:55.000Z","dependencies_parsed_at":"2024-02-12T14:51:47.837Z","dependency_job_id":"a1c3c7ce-a90f-427f-a01e-723278ff201d","html_url":"https://github.com/commercelayer/contentful-commerce","commit_stats":null,"previous_names":["commercelayer/contentful-commerce"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/commercelayer/contentful-commerce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fcontentful-commerce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fcontentful-commerce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fcontentful-commerce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fcontentful-commerce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commercelayer","download_url":"https://codeload.github.com/commercelayer/contentful-commerce/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fcontentful-commerce/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267684884,"owners_count":24127701,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-07T13:09:03.632Z","updated_at":"2026-02-27T01:02:29.734Z","avatar_url":"https://github.com/commercelayer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Contentful Commerce by Commerce Layer\n\n![Contentful Commerce by Commerce Layer](/public/assets//header-light.png#gh-light-mode-only)\n![Contentful Commerce by Commerce Layer](/public/assets//header-dark.png#gh-dark-mode-only)\n\n[![Install to Contentful](https://www.ctfstatic.com/button/install-small.svg)](https://app.contentful.com/deeplink?link=apps\u0026id=5AuHBmPgmRNIwuxHhVu9PD\u0026referrer=commercelayer)\n\n## Introduction\n\nWelcome to the Contentful Commerce App, your gateway to integrating a powerful product catalog within Contentful, leveraging the seamless transactional capabilities of Commerce Layer. This app simplifies the process of creating and managing a flexible ecommerce content model, providing you with the tools to curate an engaging and efficient online storefront.\n\n## What is Commerce Layer?\n\n[Commerce Layer](https://commercelayer.io) is a multi-market commerce API and order management system that lets you add global shopping capabilities to any website, mobile app, chatbot, wearable, voice, or IoT device, with ease. Compose your stack with the best-of-breed tools you already mastered and love. Make any experience shoppable, anywhere, through a blazing-fast, enterprise-grade, and secure API.\n\n## Features\n\n- **Custom Content Type Labels**: Personalize the names of your content types to align with your branding and content strategy.\n- **Simplified Product Catalog Management**: Manage products, variants, and categories within Contentful's intuitive interface, streamlining your content operations and e-commerce management.\n- **Localization Support**: Configure your content types to support multiple languages, making your product catalog globally accessible.\n\n## Installation Guide\n\nTo install the Contentful Commerce app in your Contentful space, follow these steps:\n\n1. Navigate to the Contentful Marketplace and locate the Contentful Commerce app.\n2. Click on \"Install\" and follow the prompts to add the app to your space.\n3. Once installed, go to the app configuration page within your Contentful space.\n4. Customize the labels for your product, variant, taxonomy, and catalog content types as needed.\n5. Save your configuration to apply the changes.\n\nEnjoy a cohesive content and commerce experience with Contentful Commerce, built by Commerce Layer.\n\n## Core Concepts\n\n- Catalog: A catalog is a collection of products, often tailored for different markets or seasons. It acts as a container for your product offerings, allowing for organization and easy management within a specific context.\n- Taxonomy: A taxonomy is a hierarchical system for classifying and organizing content. It is used to group products into broad categories, such as 'Clothing' or 'Electronics', which can then be broken down into more specific subcategories.\n- Taxon: A taxon is an individual category within a taxonomy. Taxons can be nested, allowing you to create a detailed structure for product classification.\n- Product: A product represents an individual item for sale. It is the core of your ecommerce catalog and can be associated with multiple variants.\n- Variant: A variant is a specific version of a product, which might differ in size, color, or other attributes. Each variant is a unique combination of these attributes and is typically associated with a unique SKU.\n\n## Relationships and Hierarchy\n\n- Products are linked to Variants, which define the different purchasable versions of a product.\n- Taxonomies organize Taxons into a hierarchical structure, providing a framework for categorizing products.\n- Catalogs group products and their related taxonomies to present a curated collection to the end-user.\n\n## Contribute\n\n\u003e This project was bootstrapped with [Create Contentful App](https://github.com/contentful/create-contentful-app).\n\n### Available scripts\n\nIn the project directory, you can run:\n\n#### `pnpm start`\n\nCreates or updates your app definition in Contentful, and runs the app in development mode.\nOpen your app to view it in the browser.\n\nThe page will reload if you make edits.\nYou will also see any lint errors in the console.\n\n#### `pnpm run build`\n\nBuilds the app for production to the `build` folder.\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\nYour app is ready to be deployed!\n\n#### `pnpm run upload`\n\nUploads the build folder to contentful and creates a bundle that is automatically activated.\nThe command guides you through the deployment process and asks for all required arguments.\nRead [here](https://www.contentful.com/developers/docs/extensibility/app-framework/create-contentful-app/#deploy-with-contentful) for more information about the deployment process.\n\n#### `pnpm run upload-ci`\n\nSimilar to `pnpm run upload` it will upload your app to contentful and activate it. The only difference is  \nthat with this command all required arguments are read from the environment variables, for example when you add\nthe upload command to your CI pipeline.\n\nFor this command to work, the following environment variables must be set:\n\n- `CONTENTFUL_ORG_ID` - The ID of your organization\n- `CONTENTFUL_APP_DEF_ID` - The ID of the app to which to add the bundle\n- `CONTENTFUL_ACCESS_TOKEN` - A personal [access token](https://www.contentful.com/developers/docs/references/content-management-api/#/reference/personal-access-tokens)\n\n## Libraries to use\n\nTo make your app look and feel like Contentful use the following libraries:\n\n- [Forma 36](https://f36.contentful.com/) – Contentful's design system\n- [Contentful Field Editors](https://www.contentful.com/developers/docs/extensibility/field-editors/) – Contentful's field editor React components\n\n## Using the `contentful-management` SDK\n\nIn the default create contentful app output, a contentful management client is\npassed into each location. This can be used to interact with Contentful's\nmanagement API. For example\n\n```js\n// Use the client\ncma.locale.getMany({}).then((locales) =\u003e console.log(locales));\n```\n\nVisit the [`contentful-management` documentation](https://www.contentful.com/developers/docs/extensibility/app-framework/sdk/#using-the-contentful-management-library)\nto find out more.\n\n## License\n\nThis repository is published under the [MIT](LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercelayer%2Fcontentful-commerce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommercelayer%2Fcontentful-commerce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercelayer%2Fcontentful-commerce/lists"}