diff --git a/docs/content/deployments/storefront/deploying-next-on-vercel.mdx b/docs/content/deployments/storefront/deploying-next-on-vercel.mdx index 0d7309eff7..7dd86772c0 100644 --- a/docs/content/deployments/storefront/deploying-next-on-vercel.mdx +++ b/docs/content/deployments/storefront/deploying-next-on-vercel.mdx @@ -6,11 +6,11 @@ addHowToData: true import Troubleshooting from '@site/src/components/Troubleshooting' import CorsErrorSection from '../../troubleshooting/cors-issues.md' -# Deploy Next.js Storefront on Vercel +# Deploy Next.js Starter Template on Vercel -In this document, you’ll learn how to deploy the Next.js Storefront on Vercel. +In this document, you’ll learn how to deploy the Next.js Starter Template on Vercel. -Alternatively, you can directly deploy the Next.js storefront to Vercel with this button. +Alternatively, you can directly deploy the Next.js Starter Template to Vercel with this button. @@ -21,9 +21,9 @@ Alternatively, you can directly deploy the Next.js storefront to Vercel with thi ### Medusa Components -It is assumed you already have installed the Next.js storefront locally. If not, please follow along with [this guide](../../starters/nextjs-medusa-starter.mdx) instead. +It is assumed you already have installed the Next.js Starter Template locally. If not, please follow along with [this guide](../../starters/nextjs-medusa-starter.mdx) instead. -It’s also assumed you already have the Medusa backend deployed, which the Next.js storefront interacts with. If not, you can check out one of the [deployment documentation related to the Medusa backend](../server/index.mdx). +It’s also assumed you already have the Medusa backend deployed, which the Next.js Starter Template interacts with. If not, you can check out one of the [deployment documentation related to the Medusa backend](../server/index.mdx). ### Required Accounts @@ -50,7 +50,7 @@ This step is only required if you’re deploying from the Vercel website. Howeve ::: -Before you can deploy your Next.js storefront, you need to create a GitHub repository and push the code base to it. To do that: +Before you can deploy your Next.js Starter Template, you need to create a GitHub repository and push the code base to it. To do that: 1. On GitHub, click the plus icon at the top right, then click New Repository. 2. You’ll then be redirected to a new page with a form. In the form, enter the Repository Name. @@ -62,7 +62,7 @@ The next step is to push the code to the GitHub repository you just created. After creating the repository, you’ll be redirected to the repository’s page. On that page, you should see a URL that you can copy to connect your repository to a local directory. -Copy the link. Then, open your terminal in the directory that holds your Next.js storefront codebase and run the following commands: +Copy the link. Then, open your terminal in the directory that holds your Next.js Starter Template codebase and run the following commands: ```bash git init @@ -94,7 +94,7 @@ This section explains how to deploy the storefront using the Vercel website: 1. Open the [Vercel dashboard](https://vercel.com/dashboard) after logging in. 2. Click on the “Add New…” button next to the search bar. 3. Choose Project from the dropdown. -4. In the new page that opens, find the Git repository that holds your Next.js storefront and click on the Import button. If you haven’t connected your Vercel account to any Git provider, you must do that first. +4. In the new page that opens, find the Git repository that holds your Next.js Starter Template and click on the Import button. If you haven’t connected your Vercel account to any Git provider, you must do that first. 5. In the Configure Project form: 1. Open the Environment Variables collapsible, and add an environment variable with the name `NEXT_PUBLIC_MEDUSA_BACKEND_URL` and the value being the URL to your deployed Medusa Backend. 2. You can optionally edit the Project Name. @@ -138,11 +138,11 @@ At this point, when you visit the storefront, you will face errors related to Cr ## Step 3: Configure CORS on the Medusa Backend -To send requests to the Medusa backend from the Next.js storefront, you must set the `STORE_CORS` environment variable on your backend to the Next.js storefront’s URL. +To send requests to the Medusa backend from the Next.js Starter Template, you must set the `STORE_CORS` environment variable on your backend to the Next.js Starter Template’s URL. :::tip -If you want to set a custom domain to your Next.js storefront website on Vercel, make sure to do it before this step. You can refer to this guide on [Vercel’s documentation](https://vercel.com/docs/concepts/projects/domains/add-a-domain). +If you want to set a custom domain to your Next.js Starter Template website on Vercel, make sure to do it before this step. You can refer to this guide on [Vercel’s documentation](https://vercel.com/docs/concepts/projects/domains/add-a-domain). ::: @@ -152,9 +152,9 @@ On your Medusa backend, add the following environment variable: STORE_CORS= ``` -Where `` is the URL of your Next.js storefront that you just deployed. +Where `` is the URL of your Next.js Starter Template that you just deployed. -Then, restart your Medusa backend. Once the backend is running again, you can use your Next.js storefront. +Then, restart your Medusa backend. Once the backend is running again, you can use your Next.js Starter Template. --- diff --git a/docs/content/development/notification/create-notification-provider.md b/docs/content/development/notification/create-notification-provider.md index de5e4fd0d4..1eab9cd1b8 100644 --- a/docs/content/development/notification/create-notification-provider.md +++ b/docs/content/development/notification/create-notification-provider.md @@ -313,7 +313,7 @@ Try now to place an order either using the [REST APIs](/api/store) or using the :::tip -If you don’t have a storefront installed you can get started with the [Next.js](../../starters/nextjs-medusa-starter.mdx) starter storefront in minutes. +If you don’t have a storefront installed you can get started with the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx) in minutes. ::: diff --git a/docs/content/homepage.mdx b/docs/content/homepage.mdx index b6535490b7..5c700785d5 100644 --- a/docs/content/homepage.mdx +++ b/docs/content/homepage.mdx @@ -126,10 +126,10 @@ Medusa provides the essential building blocks that developers can put together t { type: 'link', href: '/starters/nextjs-medusa-starter', - label: 'Next.js Storefront Quickstart', + label: 'Next.js Starter Template', customProps: { icon: Icons['nextjs'], - description: 'Install the Next.js starter storefront and use it with the Medusa backend.' + description: 'Install the Next.js starter template and use it as the storefront for the Medusa backend.' } }, ]} /> diff --git a/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx b/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx index fa4dd8f40a..7662a8e4a2 100644 --- a/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx +++ b/docs/content/modules/carts-and-checkout/storefront/implement-cart.mdx @@ -30,7 +30,7 @@ This document does not cover implementing the checkout flow. You can refer to [t It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx b/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx index 508aec3506..ad64283863 100644 --- a/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx +++ b/docs/content/modules/carts-and-checkout/storefront/implement-checkout-flow.mdx @@ -30,7 +30,7 @@ It’s recommended to go through the [Shipping Architecture Overview](../shippin It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/customers/storefront/implement-customer-profiles.mdx b/docs/content/modules/customers/storefront/implement-customer-profiles.mdx index 057386c043..1c2db7445a 100644 --- a/docs/content/modules/customers/storefront/implement-customer-profiles.mdx +++ b/docs/content/modules/customers/storefront/implement-customer-profiles.mdx @@ -38,7 +38,7 @@ You can use Medusa’s Store APIs to achieve more functionalities as well. Check It's assumed that you already have a Medusa backend installed and set up. If not, you can follow the [quickstart guide](../../../development/backend/install.mdx) to get started. -It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx b/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx index f9f206ee23..b0762fca0a 100644 --- a/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx +++ b/docs/content/modules/discounts/storefront/use-discounts-in-checkout.mdx @@ -34,7 +34,7 @@ You want to implement discount functionality in your store to allow customers to It's assumed that you already have a Medusa backend installed and set up. If not, you can follow the [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx b/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx index c926150166..650f08215c 100644 --- a/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx +++ b/docs/content/modules/gift-cards/storefront/use-gift-cards.mdx @@ -30,7 +30,7 @@ You want to implement the following features in a storefront: It's assumed that you already have a Medusa backend installed and set up. If not, you can follow the [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/orders/storefront/create-return.mdx b/docs/content/modules/orders/storefront/create-return.mdx index 13d61f515e..b385a7103f 100644 --- a/docs/content/modules/orders/storefront/create-return.mdx +++ b/docs/content/modules/orders/storefront/create-return.mdx @@ -35,7 +35,7 @@ Refunding the customer is handled by admins. You can learn how to implement or u It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/orders/storefront/create-swap.mdx b/docs/content/modules/orders/storefront/create-swap.mdx index 7854185542..0f99676bfb 100644 --- a/docs/content/modules/orders/storefront/create-swap.mdx +++ b/docs/content/modules/orders/storefront/create-swap.mdx @@ -30,7 +30,7 @@ The process of creating a swap is as follows: It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/orders/storefront/handle-order-edits.mdx b/docs/content/modules/orders/storefront/handle-order-edits.mdx index 59bb8611f9..237b210d39 100644 --- a/docs/content/modules/orders/storefront/handle-order-edits.mdx +++ b/docs/content/modules/orders/storefront/handle-order-edits.mdx @@ -48,7 +48,7 @@ You can perform other functionalities related to order editing. To learn more, c It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/orders/storefront/implement-claim-order.mdx b/docs/content/modules/orders/storefront/implement-claim-order.mdx index a809766736..b02d94434f 100644 --- a/docs/content/modules/orders/storefront/implement-claim-order.mdx +++ b/docs/content/modules/orders/storefront/implement-claim-order.mdx @@ -45,7 +45,7 @@ In this document, you’ll learn how to implement two parts of this flow: It's assumed that you already have a Medusa backend installed and set up. If not, you can follow the [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/orders/storefront/retrieve-order-details.mdx b/docs/content/modules/orders/storefront/retrieve-order-details.mdx index 145693630e..1b48afc65d 100644 --- a/docs/content/modules/orders/storefront/retrieve-order-details.mdx +++ b/docs/content/modules/orders/storefront/retrieve-order-details.mdx @@ -16,7 +16,7 @@ In this document, you’ll learn the different ways you can retrieve and view a It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/products/products.md b/docs/content/modules/products/products.md index 4af36dc967..18db956eed 100644 --- a/docs/content/modules/products/products.md +++ b/docs/content/modules/products/products.md @@ -135,7 +135,7 @@ For zero-decimal currencies, the amount is still stored as an integer without mu This logic of formatting the price is not handled in the backend. So, when you add a product variant using the Admin APIs, you must format the price as explained earlier. The backend stores the price as received from API requests. -In addition, the Medusa admin dashboard and the Next.js storefront expect the price to be of that format, so when prices are displayed for currencies that are stored multiplied by a `100`, such as USD, they’re divided by a hundred. Also, when you add or update a product variant, its price is sent to the Medusa backend as the price multiplied by a hundred. +In addition, the Medusa admin dashboard and the Next.js Starter Template expect the price to be of that format, so when prices are displayed for currencies that are stored multiplied by a `100`, such as USD, they’re divided by a hundred. Also, when you add or update a product variant, its price is sent to the Medusa backend as the price multiplied by a hundred. ### Displaying the Product Variant’s Price diff --git a/docs/content/modules/products/storefront/show-products.mdx b/docs/content/modules/products/storefront/show-products.mdx index 09a2566d5e..40114c3aa1 100644 --- a/docs/content/modules/products/storefront/show-products.mdx +++ b/docs/content/modules/products/storefront/show-products.mdx @@ -32,7 +32,7 @@ You want to add or use the following storefront functionalities: It's assumed that you already have a Medusa backend installed and set up. If not, you can follow the [quickstart guide](../../../development/backend/install.mdx) to get started. -It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/products/storefront/use-categories.mdx b/docs/content/modules/products/storefront/use-categories.mdx index f0c40e2942..5e1b7ae59f 100644 --- a/docs/content/modules/products/storefront/use-categories.mdx +++ b/docs/content/modules/products/storefront/use-categories.mdx @@ -29,7 +29,7 @@ You want to add or use the following store functionalities: It's assumed that you already have a Medusa backend installed and set up. If not, you can follow the [quickstart guide](../../../development/backend/install.mdx) to get started. -It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It's also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx b/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx index bb2b418003..7105f69540 100644 --- a/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx +++ b/docs/content/modules/regions-and-currencies/storefront/use-regions.mdx @@ -30,7 +30,7 @@ You want to implement the following in your storefront: It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx b/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx index 7ca8e3682c..40c0d3269c 100644 --- a/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx +++ b/docs/content/modules/sales-channels/storefront/use-sales-channels.mdx @@ -33,7 +33,7 @@ An alternative approach is to use Publishable API keys. You can learn how to use It's assumed that you already have a Medusa backend installed and set up. If not, you can follow our [quickstart guide](../../../development/backend/install.mdx) to get started. -It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js starter storefront](../../../starters/nextjs-medusa-starter.mdx). +It is also assumed you already have a storefront set up. It can be a custom storefront or one of Medusa’s storefronts. If you don’t have a storefront set up, you can install the [Next.js Starter Template](../../../starters/nextjs-medusa-starter.mdx). ### JS Client diff --git a/docs/content/plugins/analytics/segment.md b/docs/content/plugins/analytics/segment.md index a2d96fdffc..d664097073 100644 --- a/docs/content/plugins/analytics/segment.md +++ b/docs/content/plugins/analytics/segment.md @@ -133,7 +133,7 @@ Run your backend with the following command: npx @medusajs/medusa-cli develop ``` -Then, try triggering one of the [mentioned events earlier in this document](#events-that-the-segment-plugin-tracks). For example, you can place an order either using the [REST APIs](https://docs.medusajs.com/api/store) or using the [Next.js starter storefront](../../starters/nextjs-medusa-starter.mdx). +Then, try triggering one of the [mentioned events earlier in this document](#events-that-the-segment-plugin-tracks). For example, you can place an order either using the [REST APIs](https://docs.medusajs.com/api/store) or using the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx). After you place an order, on the Segment source that you created, click on the Debugger tab. You should see at least one event triggered for each order you place. If you click on the event, you can see the order details are passed to the event. diff --git a/docs/content/plugins/cms/contentful/customize-contentful.md b/docs/content/plugins/cms/contentful/customize-contentful.md index 741257d616..71cff58dad 100644 --- a/docs/content/plugins/cms/contentful/customize-contentful.md +++ b/docs/content/plugins/cms/contentful/customize-contentful.md @@ -9,7 +9,7 @@ In this document, you’ll learn how to customize the Contentful integration wit :::warning -This guide covers how to customize the Gatsby storefront which is now deprecated. It's recommended to integrate Contentful into either the Next.js storefront or your custom storefront. +This guide covers how to customize the Gatsby storefront which is now deprecated. It's recommended to integrate Contentful into either the Next.js Starter Template or your custom storefront. ::: diff --git a/docs/content/plugins/cms/contentful/index.md b/docs/content/plugins/cms/contentful/index.md index e52a644d49..735658d636 100644 --- a/docs/content/plugins/cms/contentful/index.md +++ b/docs/content/plugins/cms/contentful/index.md @@ -227,7 +227,7 @@ To do that: :::warning -This Gatsby storefront is deprecated. It's recommended to integrate Contentful into either the Next.js storefront or your custom storefront. +This Gatsby storefront is deprecated. It's recommended to integrate Contentful into either the Next.js Starter Template or your custom storefront. ::: diff --git a/docs/content/plugins/file-service/local.md b/docs/content/plugins/file-service/local.md index 6415aafbdc..e914102222 100644 --- a/docs/content/plugins/file-service/local.md +++ b/docs/content/plugins/file-service/local.md @@ -72,9 +72,9 @@ The files will be stored under the `upload_dir` specified in the plugin options --- -## Next.js Storefront Configuration +## Next.js Starter Template Configuration -If you’re using a [Next.js](../../starters/nextjs-medusa-starter.mdx) storefront, you need to add an additional configuration that adds the backend's domain name into the configured images domain names. This is because all URLs of product images will be from the Medusa backend. +If you’re using a [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx), you need to add an additional configuration that adds the backend's domain name into the configured images domain names. This is because all URLs of product images will be from the Medusa backend. If this configuration is not added, you’ll receive the error ["next/image Un-configured Host”](https://nextjs.org/docs/messages/next-image-unconfigured-host). diff --git a/docs/content/plugins/file-service/minio.md b/docs/content/plugins/file-service/minio.md index 1b3e604b8f..e6f73794bd 100644 --- a/docs/content/plugins/file-service/minio.md +++ b/docs/content/plugins/file-service/minio.md @@ -193,9 +193,9 @@ const plugins = [ --- -## Next.js Storefront Configuration +## Next.js Starter Template Configuration -If you’re using a [Next.js](../../starters/nextjs-medusa-starter.mdx) storefront, you need to add an additional configuration that adds the MinIO domain name into the configured images domain names. This is because all URLs of product images will be from the MinIO backend. +If you’re using a [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx), you need to add an additional configuration that adds the MinIO domain name into the configured images domain names. This is because all URLs of product images will be from the MinIO backend. If this configuration is not added, you’ll receive the error ["next/image Un-configured Host”](https://nextjs.org/docs/messages/next-image-unconfigured-host). diff --git a/docs/content/plugins/file-service/s3.mdx b/docs/content/plugins/file-service/s3.mdx index 5cb5e07900..5ed9d43c80 100644 --- a/docs/content/plugins/file-service/s3.mdx +++ b/docs/content/plugins/file-service/s3.mdx @@ -195,9 +195,9 @@ You can also check that the image was uploaded on the S3 bucket’s page. --- -## Next.js Storefront Configuration +## Next.js Starter Template Configuration -If you’re using a [Next.js](../../starters/nextjs-medusa-starter.mdx) storefront, you need to add an additional configuration that adds the S3 bucket domain name into the configured images’ domain names. This is because all URLs of product images will be from the S3 bucket. +If you’re using a [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx), you need to add an additional configuration that adds the S3 bucket domain name into the configured images’ domain names. This is because all URLs of product images will be from the S3 bucket. If this configuration is not added, you’ll receive the error ["next/image Un-configured Host”](https://nextjs.org/docs/messages/next-image-unconfigured-host). @@ -238,6 +238,6 @@ Where `` is the name of the S3 bucket you’re using. ## See Also -- Check out [more plugins](../overview.mdx) you can add to your store. +- Check out [more plugins](../overview.mdx) you can add to your store - [Deploy the Medusa backend](../../deployments/server/index.mdx) -- Install the [Next.js](../../starters/nextjs-medusa-starter.mdx) starter storefront. +- Install the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx) diff --git a/docs/content/plugins/file-service/spaces.md b/docs/content/plugins/file-service/spaces.md index 6b6ab41f67..d29d0077be 100644 --- a/docs/content/plugins/file-service/spaces.md +++ b/docs/content/plugins/file-service/spaces.md @@ -152,9 +152,9 @@ You can also check that the image was uploaded on the Space’s page. --- -## Next.js Storefront Configuration +## Next.js Starter Template Configuration -If you’re using a [Next.js](../../starters/nextjs-medusa-starter.mdx) storefront, you need to add an additional configuration that adds the Space’s domain name into the configured images’ domain names. This is because all URLs of product images will be from the Space. +If you’re using a [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx), you need to add an additional configuration that adds the Space’s domain name into the configured images’ domain names. This is because all URLs of product images will be from the Space. If this configuration is not added, you’ll receive the error ["next/image Un-configured Host”](https://nextjs.org/docs/messages/next-image-unconfigured-host). @@ -182,6 +182,6 @@ Where `` is the domain name for your Space which can be retri ## See Also -- Check out [more plugins](../overview.mdx) you can add to your store. -- [Deploy the Medusa backend on DigitalOcean](../../deployments/server/deploying-on-digital-ocean.md). -- Install the [Next.js](../../starters/nextjs-medusa-starter.mdx) starter storefront. +- Check out [more plugins](../overview.mdx) you can add to your store +- [Deploy the Medusa backend on DigitalOcean](../../deployments/server/deploying-on-digital-ocean.md) +- Install the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx) diff --git a/docs/content/plugins/notifications/sendgrid.mdx b/docs/content/plugins/notifications/sendgrid.mdx index 5e5adf60f9..13028d6d1d 100644 --- a/docs/content/plugins/notifications/sendgrid.mdx +++ b/docs/content/plugins/notifications/sendgrid.mdx @@ -3969,7 +3969,7 @@ To test it out, perform an action that would trigger one of the emails being sen :::tip -If you don’t have a storefront installed, check out the [Next.js](../../starters/nextjs-medusa-starter.mdx) starter storefront. +If you don’t have a storefront installed, check out the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx). ::: diff --git a/docs/content/plugins/notifications/slack.md b/docs/content/plugins/notifications/slack.md index 7de70dadfb..a89b46f8a0 100644 --- a/docs/content/plugins/notifications/slack.md +++ b/docs/content/plugins/notifications/slack.md @@ -103,4 +103,4 @@ That’s all you need to do to integrate Slack into Medusa! ## See Also - Install [Medusa's Admin](../../admin/quickstart.mdx) for the full order-management experience. -- Install the [Next.js](../../starters/nextjs-medusa-starter.mdx) starter storefront. +- Install the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx). diff --git a/docs/content/plugins/notifications/twilio-sms.md b/docs/content/plugins/notifications/twilio-sms.md index 0dc3d80fe9..edf997b752 100644 --- a/docs/content/plugins/notifications/twilio-sms.md +++ b/docs/content/plugins/notifications/twilio-sms.md @@ -127,7 +127,7 @@ If you create an order now on your storefront, you should receive a message from :::tip -If you don’t have a storefront set up yet, you can install the [Next.js starter storefront](../../starters/nextjs-medusa-starter.mdx). +If you don’t have a storefront set up yet, you can install the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx). ::: diff --git a/docs/content/plugins/payment/paypal.md b/docs/content/plugins/payment/paypal.md index 445fcfc411..e6db447928 100644 --- a/docs/content/plugins/payment/paypal.md +++ b/docs/content/plugins/payment/paypal.md @@ -109,7 +109,7 @@ All storefronts require that you obtain your PayPal Client ID. You can retrieve ### Process Overview -Aside from the Next.js Storefront, you need to add the implementation with PayPal manually. +Aside from the Next.js Starter Template, you need to add the implementation with PayPal manually. :::note @@ -130,9 +130,9 @@ In Medusa, by default, payments are authorized during checkout, but the payment ::: -### Add to Next.js Storefront +### Add to Next.js Starter Template -Medusa has a Next.js storefront that you can easily use with your Medusa backend. If you don’t have the storefront installed, you can follow [this quickstart guide](../../starters/nextjs-medusa-starter.mdx). +Medusa has a Next.js Starter Template that you can easily use with your Medusa backend. If you don’t have the storefront installed, you can follow [this quickstart guide](../../starters/nextjs-medusa-starter.mdx). In your `.env.local` file (or the file you’re using for your environment variables), add the following variable: diff --git a/docs/content/plugins/payment/stripe.mdx b/docs/content/plugins/payment/stripe.mdx index c12bfad3b1..26541eb05d 100644 --- a/docs/content/plugins/payment/stripe.mdx +++ b/docs/content/plugins/payment/stripe.mdx @@ -139,9 +139,9 @@ This guide will take you through how to set up Stripe payments in your Medusa st All storefronts require that you obtain your Stripe’s Publishable Key. You can retrieve it from your Stripe’s developer dashboard by choosing API Keys and then copying the Publishable Key. -### Add to Next.js Storefront +### Add to Next.js Starter Template -Medusa has a Next.js storefront that you can easily use with your Medusa backend. If you don’t have the storefront installed, you can follow [this quickstart guide](../../starters/nextjs-medusa-starter). +Medusa has a Next.js Starter Template that you can easily use with your Medusa backend. If you don’t have the storefront installed, you can follow [this quickstart guide](../../starters/nextjs-medusa-starter). In your `.env.local` file (or the file you’re using for your environment variables), add the following variable: diff --git a/docs/content/plugins/search/algolia.md b/docs/content/plugins/search/algolia.md index b6f44ade3a..486d7cfc73 100644 --- a/docs/content/plugins/search/algolia.md +++ b/docs/content/plugins/search/algolia.md @@ -225,7 +225,7 @@ This feature is only available if you have an event module installed in your Med ## Add Search to your Storefront -In this section, you’ll learn how to add the UI on your storefront to allow searching with Algolia. This section has instructions for Medusa’s [Next.js](../../starters/nextjs-medusa-starter.mdx) storefront as well as React-based frameworks. +In this section, you’ll learn how to add the UI on your storefront to allow searching with Algolia. This section has instructions for Medusa’s [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx) as well as React-based frameworks. ### Storefront Prerequisites @@ -233,13 +233,13 @@ It is assumed you already have a storefront set up and working with the Medusa b :::tip -If you don’t have a storefront set up, you can use the [Next.js starter storefront](../../starters/nextjs-medusa-starter.mdx) that Medusa provides. +If you don’t have a storefront set up, you can use the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx) that Medusa provides. ::: -### Add to Next.js Storefront +### Add to Next.js Starter Template -The Next.js storefront has the Algolia integration available out of the box. To get it working, you just need to follow three steps. +The Next.js Starter Template has the Algolia integration available out of the box. To get it working, you just need to follow three steps. First, ensure that the search feature is enabled in `store.config.json`: @@ -277,15 +277,15 @@ export const SEARCH_INDEX_NAME = process.env.NEXT_PUBLIC_INDEX_NAME || "products" ``` -If you run your Next.js storefront now while the Medusa backend is running, the search functionality will be available in your storefront. +If you run your Next.js Starter Template now while the Medusa backend is running, the search functionality will be available in your storefront. :::note -To make sure the Next.js storefront properly displays the products in the search result, include in the `attributesToRetrieve` setting of the Algolia plugin on the Medusa backend at least the fields `title`, `handle`, `description`, and `thumbnail`. +To make sure the Next.js Starter Template properly displays the products in the search result, include in the `attributesToRetrieve` setting of the Algolia plugin on the Medusa backend at least the fields `title`, `handle`, `description`, and `thumbnail`. ::: -![Search pop up in the Next.js storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000082/Medusa%20Docs/Algolia/1f9qqK6_c0z8zi.png) +![Search pop up in the Next.js Starter Template](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000082/Medusa%20Docs/Algolia/1f9qqK6_c0z8zi.png) ### Add to Other Storefronts diff --git a/docs/content/plugins/search/meilisearch.md b/docs/content/plugins/search/meilisearch.md index e0a2cc3685..44d87613cf 100644 --- a/docs/content/plugins/search/meilisearch.md +++ b/docs/content/plugins/search/meilisearch.md @@ -186,7 +186,7 @@ This feature is only available if you have an event module installed in your Med ## Add Search to your Storefront -In this section, you’ll learn how to add the UI on your storefront to allow searching with MeiliSearch. This section has instructions for Medusa’s [Next.js](../../starters/nextjs-medusa-starter.mdx) storefront as well as React-based frameworks. +In this section, you’ll learn how to add the UI on your storefront to allow searching with MeiliSearch. This section has instructions for Medusa’s [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx) as well as React-based frameworks. ### Storefront Prerequisites @@ -194,7 +194,7 @@ It is assumed you already have a storefront set up and working with the Medusa b :::tip -If you don’t have a storefront set up, you can use the [Next.js starter storefront](../../starters/nextjs-medusa-starter.mdx) that Medusa provides. +If you don’t have a storefront set up, you can use the [Next.js Starter Template](../../starters/nextjs-medusa-starter.mdx) that Medusa provides. ::: @@ -217,9 +217,9 @@ Make sure to replace `` and `` accordi If this request is successful, the API key will be available under the `key` property returned in the JSON response. -### Add to Next.js Storefront +### Add to Next.js Starter Template -The Next.js storefront has the MeiliSearch integration available out of the box. To get it working, you just need to follow two steps. +The Next.js Starter Template has the MeiliSearch integration available out of the box. To get it working, you just need to follow two steps. First, ensure that the search feature is enabled in `store.config.json`: @@ -241,15 +241,15 @@ NEXT_PUBLIC_SEARCH_INDEX_NAME=products Make sure to replace `` with your MeiliSearch host and `` with the API key you created as instructed in the [Storefront Prerequisites](#storefront-prerequisites) section. -If you run your Next.js storefront now while the Medusa backend and the MeiliSearch services are running, the search functionality will be available in your storefront. +If you run your Next.js Starter Template now while the Medusa backend and the MeiliSearch services are running, the search functionality will be available in your storefront. :::note -To make sure the Next.js storefront properly displays the products in the search result, include in the `displayedAttributes` setting of the MeiliSearch plugin on the Medusa backend at least the fields `title`, `handle`, `description`, and `thumbnail`. +To make sure the Next.js Starter Template properly displays the products in the search result, include in the `displayedAttributes` setting of the MeiliSearch plugin on the Medusa backend at least the fields `title`, `handle`, `description`, and `thumbnail`. ::: -![Search Result on Next.js storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000298/Medusa%20Docs/MeiliSearch/gQVWvH2_datei5.png) +![Search Result on Next.js Starter Template](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000298/Medusa%20Docs/MeiliSearch/gQVWvH2_datei5.png) ### Add to Other Storefronts diff --git a/docs/content/recipes/marketplace.mdx b/docs/content/recipes/marketplace.mdx index 96b731fafc..69a43c0a7b 100644 --- a/docs/content/recipes/marketplace.mdx +++ b/docs/content/recipes/marketplace.mdx @@ -354,16 +354,16 @@ Payment and fulfillment providers are associated with regions, which are not ass ## Build a Storefront -Medusa provides a Next.js starter storefront that you can use with Medusa. Since you've customized your Medusa project, you'll need to either customize the existing Next.js storefront, or create a custom storefront. +Medusa provides a Next.js Starter Template that you can use with Medusa. Since you've customized your Medusa project, you'll need to either customize the existing Next.js Starter Template, or create a custom storefront. @@ -23,16 +23,16 @@ This document guides you to install and set up the Next.js Starter Storefront. type: 'note' }} > - We've deprecated the Gatsby starter storefront and instead recommend using the Next.js storefront or building your own custom storefront. + We've deprecated the Gatsby starter storefront and instead recommend using the Next.js Starter Template or [building your own custom storefront](../storefront/roadmap.mdx). -![Next.js Storefront Demo](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003177/Medusa%20Docs/Screenshots/koJl8uR_n3gvii.gif) +![Next.js Starter Template Demo](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003177/Medusa%20Docs/Screenshots/koJl8uR_n3gvii.gif) ## Instant Deployment to Vercel -Instead of manually following this guide to install then later deploy the Next.js Storefront, you can deploy the Next.js Storefront to Vercel with this button: +Instead of manually following this guide to install then later deploy the Next.js Starter Template, you can deploy the Next.js Starter Template to Vercel with this button: @@ -76,7 +76,7 @@ mv .env.template .env.local npm run dev ``` -Your Next.js storefront is now running at `localhost:8000` +Your Next.js Starter Template is now running at `localhost:8000` @@ -159,17 +159,17 @@ Then, restart the Next.js backend. You’ll be able to search through available :::note -To make sure the Next.js storefront properly displays the products in the search result, include in the `displayedAttributes` setting of the MeiliSearch plugin on the Medusa backend at least the fields `title`, `handle`, `description`, and `thumbnail`. +To make sure the Next.js Starter Template properly displays the products in the search result, include in the `displayedAttributes` setting of the MeiliSearch plugin on the Medusa backend at least the fields `title`, `handle`, `description`, and `thumbnail`. ::: -![Search Result on Next.js storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003191/Medusa%20Docs/Screenshots/gQVWvH2_h1ljig.png) +![Search Result on Next.js Starter Template](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003191/Medusa%20Docs/Screenshots/gQVWvH2_h1ljig.png) ### Algolia Integration Instead of using the default MeiliSearch search engine, you can switch to using Algolia. Make sure you start by installing the Algolia plugin on your Medusa backend. You can do it by [following this guide](../plugins/search/algolia.md). -In your Next.js storefront, set the environment variables necessary for the Algolia integration: +In your Next.js Starter Template, set the environment variables necessary for the Algolia integration: ```bash NEXT_PUBLIC_SEARCH_APP_ID= @@ -198,13 +198,13 @@ export const SEARCH_INDEX_NAME = Then, restart the Next.js backend. You’ll be able to search through available products by clicking the search icon in the navigation bar. -![Search Pop-up in Next.js Storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003205/Medusa%20Docs/Screenshots/ZLgX5Ad_po6a4n.png) +![Search Pop-up in Next.js Starter Template](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003205/Medusa%20Docs/Screenshots/ZLgX5Ad_po6a4n.png) ### Stripe Payment Integration Stripe integration is supported by default. Make sure you have Stripe installed and enabled on your Medusa backend first. You can [follow this guide to learn how to install it](../plugins/payment/stripe.mdx). -Then, in your Next.js storefront, set the environment variable necessary for the Stripe integration: +Then, in your Next.js Starter Template, set the environment variable necessary for the Stripe integration: ```bash NEXT_PUBLIC_STRIPE_KEY= @@ -220,7 +220,7 @@ If you restart your Next.js backend you should be able to pay with Stripe on che PayPal integration is supported by default. Make sure you have PayPal installed and enabled on your Medusa backend first. You can [follow this guide to learn how to install it](../plugins/payment/paypal.md). -Then, in your Next.js storefront, set the environment variable necessary for the PayPal integration: +Then, in your Next.js Starter Template, set the environment variable necessary for the PayPal integration: ```bash NEXT_PUBLIC_PAYPAL_CLIENT_ID= @@ -242,7 +242,7 @@ To customize the styles of the storefront, you can customize the `src/styles` di ### Change Port -By default, the Next.js storefront runs on port `8000`. +By default, the Next.js Starter Template runs on port `8000`. To change the port, change the `develop` command in `package.json` to the following: diff --git a/docs/content/storefront/roadmap.mdx b/docs/content/storefront/roadmap.mdx index dbeaf4b5eb..c73d7e82df 100644 --- a/docs/content/storefront/roadmap.mdx +++ b/docs/content/storefront/roadmap.mdx @@ -12,7 +12,7 @@ In this document, you’ll learn about the different resources you need and the ## Overview -Although Medusa provides a Next.js starter storefront, you have full freedom in how you choose to build your storefront. This includes anything from what framework you choose to what functionalities you choose to include. +Although Medusa provides a Next.js Starter Template, you have full freedom in how you choose to build your storefront. This includes anything from what framework you choose to what functionalities you choose to include. This guide provides a roadmap that can guide you into how you can build your own storefront, regardless of what tools you’re using. diff --git a/docs/content/troubleshooting/common-installation-errors/_module-x-error.mdx b/docs/content/troubleshooting/common-installation-errors/_module-x-error.mdx index b0040e6dbe..a4042e23c2 100644 --- a/docs/content/troubleshooting/common-installation-errors/_module-x-error.mdx +++ b/docs/content/troubleshooting/common-installation-errors/_module-x-error.mdx @@ -1,7 +1,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -This error can occur while installing any of Medusa's projects (for example, Next.js storefront). There is no specific cause to this error. +This error can occur while installing any of Medusa's projects (for example, Next.js Starter Template). There is no specific cause to this error. One way to resolve it is by removing the `node_modules` directory in the project and re-installing the dependencies: diff --git a/www/docs/sidebars.js b/www/docs/sidebars.js index d3998cd021..731498d4a0 100644 --- a/www/docs/sidebars.js +++ b/www/docs/sidebars.js @@ -134,7 +134,7 @@ module.exports = { { type: "doc", id: "starters/nextjs-medusa-starter", - label: "Next.js Storefront", + label: "Next.js Starter Template", customProps: { sidebar_icon: "nextjs", }, diff --git a/www/docs/src/utils/learning-paths.tsx b/www/docs/src/utils/learning-paths.tsx index 80855eced1..e226fe7d02 100644 --- a/www/docs/src/utils/learning-paths.tsx +++ b/www/docs/src/utils/learning-paths.tsx @@ -9,9 +9,9 @@ const paths: LearningPathType[] = [ description: "Create and deploy a full-fledged ecommerce store.", steps: [ { - title: "Create a Next.js storefront", + title: "Create a Next.js Starter Template", description: - "Create a Next.js storefront and connect it to your Medusa backend.", + "Create a Next.js Starter Template and connect it to your Medusa backend.", path: "/starters/nextjs-medusa-starter", }, { @@ -100,7 +100,7 @@ const paths: LearningPathType[] = [ path: "/starters/nextjs-medusa-starter", descriptionJSX: ( <> - Build a storefront either using the Next.js starter or{" "} + Build a storefront either using the Next.js Starter Template or{" "} from scratch. ), @@ -168,7 +168,7 @@ const paths: LearningPathType[] = [ path: "/starters/nextjs-medusa-starter", descriptionJSX: ( <> - Build a storefront either using the Next.js starter or{" "} + Build a storefront either using the Next.js Starter Template or{" "} from scratch. ),