gburri/recipes
1
0
Fork 0
Code Issues 6 Pull requests Projects Releases Packages Wiki Activity Actions

Update README

Browse source
This commit is contained in:
Greg Burri 2025-04-05 13:41:06 +02:00
parent 0c2e4b7624
commit eae4cec872
1 changed files with 24 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

41
README.md
View file

@ -1,53 +1,59 @@
**Recipes** is a multi-user website to manage and publish cooking recipes.
# Technical
## Backend
### Launch Axum
In directory '/backend' type:
$> cargo run
In directory /backend type:
Then browse http://127.0.0.1:8082 (You need to compile the wasm file first, see section 'Frontend')
```$> cargo run```
Then browse http://127.0.0.1:8082 (You need to compile the wasm file first, see section *Frontend*)
At first launch the configuration file '/backend/conf.ron' is created. It contains the port the server will listen to and information about the SMTP server which will be used to send email when a user sign up or change its password.
### Autoreload
First install cargo watch:
$> cargo install cargo-watch
In directory '/backend' type:
$> cargo watch -x run
```$> cargo install cargo-watch```
In directory /backend type:
```$> cargo watch -x run```
## Frontend
### Tools needed
nushell: https://www.nushell.sh/
trunk: https://trunkrs.dev
### Compilation
In directory '/frontend' type:
$> nu deploy.nu
In directory /frontend type:
It will create the '/frontend/pkg' directory and copy the wasm file into '/backend/static'.
```$> trunk build```
It will create the wasm file in '/backend/static'.
You can now refresh your browser to reload the wasm file.
# How-to
## How to install service on a Linux server
## How to install service on a Linux server (with *systemd*)
As root:
1. Copy '/doc/recipes.service' to '/lib/systemd/system/'
2. Enabled it: #> systemctl enable recipes
3. Launch it: #> systemctl start recipes
2. Change the values of `User`, `WorkingDirectory` and `ExecStart`.
2. Enabled it: `#> systemctl enable recipes`
3. Launch it: `#> systemctl start recipes`
## Cross compile for Raspberry PI on Windows
* $> https://gnutoolchains.com/raspberry/
* https://gnutoolchains.com/raspberry/
* https://gnutoolchains.com/raspberry64/
# Useful URLs
@ -60,6 +66,7 @@ As root:
# Useful tools
HTTP benchmarking and stress tool: https://crates.io/crates/oha
HTTP API tool: https://www.usebruno.com/
GUI Database client: https://dbeaver.io/
* nushell (.nu scripts): https://www.nushell.sh/
* HTTP benchmarking and stress tool: https://crates.io/crates/oha
* HTTP API tool: https://www.usebruno.com/
* GUI Database client: https://dbeaver.io/