2022-12-21 15:39:54 +00:00
|
|
|

|
2022-12-12 13:38:14 +00:00
|
|
|
|
2022-12-21 15:39:54 +00:00
|
|
|
<div align="center">
|
|
|
|
<h1>Saleor Apps</h1>
|
|
|
|
</div>
|
2022-12-12 13:38:14 +00:00
|
|
|
|
2022-12-21 15:39:54 +00:00
|
|
|
<div align="center">
|
|
|
|
<p>The central space for Saleor Apps, Integrations and Marketplace.
|
|
|
|
</div>
|
2022-12-12 13:38:14 +00:00
|
|
|
|
2022-12-21 15:39:54 +00:00
|
|
|
<div align="center">
|
|
|
|
<a href="https://saleor.io/">🏠 Website</a>
|
|
|
|
<span> • </span>
|
2023-02-10 14:24:44 +00:00
|
|
|
<a href="https://docs.saleor.io/docs/3.x">📚 Docs</a>
|
2022-12-21 15:39:54 +00:00
|
|
|
<span> • </span>
|
|
|
|
<a href="https://saleor.io/blog/">📰 Blog</a>
|
|
|
|
<span> • </span>
|
|
|
|
<a href="https://twitter.com/getsaleor">🐦 Twitter</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div align="center">
|
2023-02-10 14:24:44 +00:00
|
|
|
<a href="https://docs.saleor.io/docs/3.x/developer/extending/apps/quickstart/getting-started">🆕 Apps Quickstart</a>
|
|
|
|
<span> • </span>
|
|
|
|
<a href="https://github.com/orgs/saleor/projects/22/views/1">🗓️ Roadmap</a>
|
|
|
|
<span> • </span>
|
|
|
|
<a href="https://github.com/saleor/apps/discussions/categories/integrations-features">✍️ Propose an app</a>
|
2022-12-21 15:39:54 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
|
|
|
|
This repository serves as a starting point in the exploration of Saleor apps.
|
|
|
|
|
|
|
|
> _Saleor apps are separate applications that use GraphQL to talk to the Saleor server and receive webhooks with event notifications from Saleor._
|
2023-02-10 10:13:59 +00:00
|
|
|
>
|
2022-12-21 15:39:54 +00:00
|
|
|
> [docs.saleor.io](https://docs.saleor.io/docs/3.x/developer/extending/apps/key-concepts)
|
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
### Apps list
|
|
|
|
|
|
|
|
In the `apps` folder, you will find the following applications:
|
|
|
|
|
|
|
|
- [data-importer](./apps/data-importer) - import data from CSV to Saleor.
|
|
|
|
- [invoices](./apps/invoices) - generate invoice PDF for each order.
|
|
|
|
- [klaviyo](./apps/klaviyo) - send Saleor events to Klaviyo, where you can notify the customers.
|
2023-03-09 08:14:29 +00:00
|
|
|
- [emails-and-messages](./apps/emails-and-messages) - notifications and email communication with customers.
|
2023-02-10 14:24:44 +00:00
|
|
|
- [search](./apps/search) - connect Saleor with search engines.
|
|
|
|
- [slack](./apps/slack) - get notifications on Slack channel from Saleor events.
|
2023-03-02 11:01:17 +00:00
|
|
|
- [taxes](./apps/taxes) - calculate order and checkout taxes using external services.
|
2023-03-16 11:38:48 +00:00
|
|
|
- [cms](./apps/cms) - exports products from Saleor to CMS.
|
2023-02-10 14:24:44 +00:00
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
### Setup
|
|
|
|
|
|
|
|
Make sure you have installed `pnpm`:
|
2023-02-21 10:34:30 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
```bash
|
|
|
|
npm install -g pnpm
|
|
|
|
```
|
|
|
|
|
|
|
|
Install all dependencies:
|
2023-02-21 10:34:30 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
```bash
|
|
|
|
pnpm install
|
|
|
|
```
|
|
|
|
|
|
|
|
Start the apps` dev servers:
|
2023-02-21 10:34:30 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
```bash
|
|
|
|
pnpm dev
|
|
|
|
```
|
|
|
|
|
|
|
|
> The apps' ports will be displayed in the terminal output.
|
|
|
|
>
|
|
|
|
> You can find the required env vars for each app in `apps/NAME/.env.example` file.
|
|
|
|
|
|
|
|
To start an individual app, run:
|
2023-02-21 10:34:30 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
```bash
|
|
|
|
pnpm dev --filter=saleor-app-X
|
|
|
|
```
|
|
|
|
|
|
|
|
where X is the app's name (matching saleor/X).
|
|
|
|
|
|
|
|
### Build
|
2023-02-21 10:34:30 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
To build all apps, run:
|
2023-02-21 10:34:30 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
```bash
|
|
|
|
pnpm build
|
|
|
|
```
|
2022-12-21 15:39:54 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
### Documentation
|
2023-02-21 10:34:30 +00:00
|
|
|
|
2023-02-10 14:24:44 +00:00
|
|
|
- [Forking](/docs/forking.md)
|