mirror of https://github.com/vercel/commerce.git synced 2025-03-15 06:52:32 +00:00

History

* Update product types

* Cart types progress, add zod & initial schema validator

* Update normalize.ts

* Update with-schema-parser.ts

* Updated types, schemas & providers

* Fix providers after schema parse errors

* Fix paths

* More provider fixes

* Fix kibocommerce & commercejs

* Add customer updated types & fixes

* Add checkout & customer types

* Import core types only from commerce

* Update tsconfig.json

* Convert hooks interfaces to types

* Requested changes

* Change to relative paths

* Move Zod dependency

2022-10-05 09:02:29 +03:00

src

Update types (#831 )

2022-10-05 09:02:29 +03:00

.env.template

chore(docs): update .env.template provider names (#721 )

2022-04-13 16:45:31 +01:00

.prettierignore

Monorepo with Turborepo (#651 )

2022-02-01 14:14:05 -05:00

.prettierrc

Monorepo with Turborepo (#651 )

2022-02-01 14:14:05 -05:00

codegen.json

Monorepo with Turborepo (#651 )

2022-02-01 14:14:05 -05:00

package.json

Upgrade dependencies & pnpm (#785 )

2022-09-19 08:14:49 +03:00

README.md

Monorepo with Turborepo (#651 )

2022-02-01 14:14:05 -05:00

schema.d.ts

Monorepo with Turborepo (#651 )

2022-02-01 14:14:05 -05:00

schema.graphql

Monorepo with Turborepo (#651 )

2022-02-01 14:14:05 -05:00

taskfile.js

Replace tsc with SWC for package compilation and file watching (#675 )

2022-02-09 10:30:59 -05:00

tsconfig.json

Monorepo with Turborepo (#651 )

2022-02-01 14:14:05 -05:00

README.md

Vendure Storefront Data Hooks

UI hooks and data fetching methods built from the ground up for e-commerce applications written in React, that use Vendure as a headless e-commerce platform.

Usage

Clone this repo and install its dependencies with yarn install or npm install

Set the Vendure provider and API URL in your .env.local file:

COMMERCE_PROVIDER=vendure
NEXT_PUBLIC_VENDURE_SHOP_API_URL=https://demo.vendure.io/shop-api
NEXT_PUBLIC_VENDURE_LOCAL_URL=/vendure-shop-api

With the Vendure server running, start this project using yarn dev or npm run dev.

Note: The Vendure server needs to be configured to use the "cookie" tokenMethod rather than "bearer" to work with this provider. For more information see the Managing Sessions docs.

Known Limitations

Vendure does not ship with built-in wishlist functionality.
Nor does it come with any kind of blog/page-building feature. Both of these can be created as Vendure plugins, however.
The entire Vendure customer flow is carried out via its GraphQL API. This means that there is no external, pre-existing checkout flow. The checkout flow must be created as part of the Next.js app. See https://github.com/vercel/commerce/issues/64 for further discusion.
By default, the sign-up flow in Vendure uses email verification. This means that using the existing "sign up" flow from this project will not grant a new user the ability to authenticate, since the new account must first be verified. Again, the necessary parts to support this flow can be created as part of the Next.js app.

Code generation

This provider makes use of GraphQL code generation. The schema.graphql and schema.d.ts files contain the generated types & schema introspection results.

When developing the provider, changes to any GraphQL operations should be followed by re-generation of the types and schema files:

From the package dir, run

yarn generate
# or
npm run generate