This repo contains the following main components:
| Crate | Description |
| ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [**saleor-app-sdk**](https://crates.io/crates/sdk) | Types and utilities for making Saleor Apps |
| [**saleor-app-template**](https://github.com/djkato/saleor-apps-rs/tree/master/app-template) | Simple template for making Saleor apps using axum |
| [**saleor-app-sitemap**](https://github.com/djkato/saleor-apps-rs/tree/master/sitemap-generator) | Saleor App for keeping sitemap.xml uptodate |
| [**saleor-app-sitemap**](https://github.com/djkato/saleor-apps-rs/tree/master/simple-payment-gateway) | Saleor App that adds payment methods: Cash on delivery, Cash on warehouse pickup, bank tranfer etc. |
# Using the apps
Pick the apps you wanna use from this repo. You can find prebuilt docker images on the right sidebar next to the code tree under "Packages".
Simply add the package to your `docker-compose.yml`, for example like so:
```yml
version: "3.4"
services:
redisapl:
image: bitnami/redis:latest
environment:
- ALLOW_EMPTY_PASSWORD=yes
ports:
- 6380:6379
restart: unless-stopped
networks:
- saleor-app-tier
volumes:
- saleor-redis:/bitnami/redis/data
saleor-app-simple-gateway:
image: ghcr.io/djkato/saleor-simple-payment-gateway:latest
restart: unless-stopped
env_file:
- ./app-simple-gateway.env
ports:
- "3030:3030"
networks:
- saleor-app-tier
depends_on:
- redisapl
networks:
saleor-app-tier:
driver: bridge
```
# Using this repo
To use, you need to have [Rust environment prepared](https://rustup.rs/).
Every folder represents a different workspace. To add a new lib, do `cargo new --lib` or `cargo new ` for binary apps. It should appear as a new member under root `Cargo.toml`
# Unofficial Saleor App SDK
SDK for building [Saleor Apps](https://github.com/saleor/apps)
to use in your project outside this repo: `cargo add saleor-app-sdk`
to use in your project inside this repo, create a new workspace member and add `saleor-app-sdk.workspace = true` to the members `Cargo.toml`
# Unofficial Saleor App Template
## Creating a new Saleor App from template
If using the `saleor-app-template`, create a new workspace member `cargo new `,`rm -rf /*` then `cp -r app-template/* /`.
## Adding new dependencies
Workspace dependencies need to be managed manually. If you wanna add a new dependency to a single member do `cargo add --package `.
If you want to use a shared dependency, add it to the root level `Cargo.toml`,
then inside your member `Cargo.toml`add it under depencency like: ` = { workspace = true, features = [ "..." ] }`.
## Developing
To have the app rebuild during development, install bacon `cargo install bacon`, then run `bacon run -- ` to have bacon watch your code and rerun it on save!
## License
Each workspace member has it's licensed in it's own directory.
### TL;DR:
- saleor-app-sdk, saleor-app-template and the root structure fall under either MIT or Apache 2.0 at your convenience.
- Rest of the apps in this repo fall under `PolyForm-Noncommercial-1.0.md`. If you want to use my apps commercially, each app costs 10€ (or voluntarily more). Upon payment/donation you are allowed to use the given app commercially.
## Docker images
To build the docker image, log into ghcr.io via docker like `docker login ghcr.io -u -p ` run `cargo make`. To publish, run `cargo push-containers`. If you want to push image to your own place, modify `Makefile.toml` and `Dockerfile` to include your username instead of mine.