An e-commerce storefront for Vendure built with Remix.
Most Vendure features are already part of this starter. Notable missing Vendure features:
- Default billing/shipping addresses
- This is part of the account page (vendure-ecommerce/storefront-remix-starter#39) but not yet used in checkout
- Separate billing address in checkout
- Promotions
- Localization
- Multi channel support
General things missing:
- Global input validation
- Sitemap generation
- Metadata
Contributions welcome!
-
Clone this repo
-
yarn install
-
Create a
.env
file in the root dir with the following command and update it with your variables:cp .env.template .env
-
yarn dev
- run the storefront with a local Remix server -
yarn dev:cf
- runs locally with the Cloudflare Pages configuration
This storefront requires a Vendure V2 server. You can either run a local instance, or use our public demo server.
If you're looking for V1 support, 75eb880 is the last supported commit.
Whenever the Graphql documents (the constants using the gql
tag) in the ./app/providers dir changes,
you should run yarn generate
to generate new sdk definitions.
For a more detailed guide on how to work with code generation, check the wiki about querying custom fields.
You can set up a local instance, populated with test data by following the instructions in the Vendure Getting Started guide. Note that make sure you have enabled the bearer
method for managing session tokens:
// vendure-config.ts
export const config: VendureConfig = {
authOptions: {
tokenMethod: ['bearer', 'cookie'], // or just 'bearer'
// ...
},
// ...
};
Currently, both Stripe and Braintree are supported out of the box, but only one of them can be used at the same time
This repo has a built-in Stripe payment integration. To enable it, ensure that your Vendure server is set up with the StripePlugin.
Ensure your new PaymentMethod uses the word stripe
somewhere in its code, as that's how this integration will know
to load the Stripe payment element.
Then add your Stripe publishable key to the env file:
STRIPE_PUBLISHABLE_KEY=pk_test_...
Important note: There's a race condition between Stripe redirecting a customer to the confirmation page and the webhook receiving the confirmation in the Vendure backend. As this condition is not very distinguishable from other potential issues, it is currently addressed by implementing a very simple retry system of 5 retries every 2.5s You can tweak these settings in the CheckoutConfirmation route.
This repo has built-in Braintree integration. To enable it, ensure that your Vendure server is set up with the BraintreePlugin.
Currently, storeCustomersInBraintree
has to be set to true
in plugin options.
There is a publicly-available demo instance at https://readonlydemo.vendure.io/shop-api
This repo is configured to deploy to either Netlify or Cloudflare Pages or to build locally with specialised build targets (build(:nf/:cf)
).
No special setup should be needed, as the remix.config.js file contains a check for the process.env.CF_PAGES
/ process.env.NETLIFY
environment variable to determine whether to use the Cloudflare Pages or Netlify server configuration.
Follow the usual procedure for setting up a project in Netlify/CF Pages and point it to your clone of this repo on GitHub/Gitlab.
Be sure to change the cookie secret in app/sessions.ts for production use!
MIT