feat(docs): document pnpm (#1251)
Co-authored-by: Dominik Pschenitschni <mail@celement.de> Reviewed-on: https://kolaente.dev/vikunja/api/pulls/1251 Co-authored-by: Dominik Pschenitschni <dpschen@noreply.kolaente.de> Co-committed-by: Dominik Pschenitschni <dpschen@noreply.kolaente.de>
This commit is contained in:
parent
53419180be
commit
36265fcedf
3 changed files with 10 additions and 12 deletions
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: "2019-02-12:00:00+02:00"
|
date: "2022-09-21:00:00+02:00"
|
||||||
title: "Development"
|
title: "Development"
|
||||||
toc: true
|
toc: true
|
||||||
draft: false
|
draft: false
|
||||||
|
@ -42,8 +42,7 @@ You need to have [pnpm](https://pnpm.io/) and nodejs in version 16 or 18 install
|
||||||
|
|
||||||
## Git flow
|
## Git flow
|
||||||
|
|
||||||
The `main` branch is the latest and bleeding edge branch with all changes. Unstable releases are automatically
|
The `main` branch is the latest and bleeding edge branch with all changes. Unstable releases are automatically created from this branch.
|
||||||
created from this branch.
|
|
||||||
|
|
||||||
A release gets tagged from the main branch with the version name as tag name.
|
A release gets tagged from the main branch with the version name as tag name.
|
||||||
|
|
||||||
|
@ -51,7 +50,6 @@ Backports and point-releases should go to a `release/version` branch, based on t
|
||||||
|
|
||||||
## Conventional commits
|
## Conventional commits
|
||||||
|
|
||||||
We're using [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) because they greatly simplify
|
We're using [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) because they greatly simplify generating release notes.
|
||||||
generating release notes.
|
|
||||||
|
|
||||||
It is not required to use them when creating a PR, but appreciated.
|
It is not required to use them when creating a PR, but appreciated.
|
||||||
|
|
|
@ -98,12 +98,12 @@ Check out the docs [in the frontend repo](https://kolaente.dev/vikunja/frontend/
|
||||||
To run the frontend unit tests, run
|
To run the frontend unit tests, run
|
||||||
|
|
||||||
{{< highlight bash >}}
|
{{< highlight bash >}}
|
||||||
pnpm test:unit
|
pnpm run test:unit
|
||||||
{{< /highlight >}}
|
{{< /highlight >}}
|
||||||
|
|
||||||
The frontend also has a watcher available that re-runs all unit tests every time you change something.
|
The frontend also has a watcher available that re-runs all unit tests every time you change something.
|
||||||
To use it, simply run
|
To use it, simply run
|
||||||
|
|
||||||
{{< highlight bash >}}
|
{{< highlight bash >}}
|
||||||
pnpm test:unit-watch
|
pnpm run test:unit-watch
|
||||||
{{< /highlight >}}
|
{{< /highlight >}}
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: "2019-02-12:00:00+02:00"
|
date: "2022-09-21:00:00+02:00"
|
||||||
title: "Build from sources"
|
title: "Build from sources"
|
||||||
draft: false
|
draft: false
|
||||||
type: "doc"
|
type: "doc"
|
||||||
|
@ -22,7 +22,7 @@ That means compiling it boils down to these steps:
|
||||||
1. Make sure [Go](https://golang.org/doc/install) is properly installed on your system. You'll need at least Go `1.17`.
|
1. Make sure [Go](https://golang.org/doc/install) is properly installed on your system. You'll need at least Go `1.17`.
|
||||||
2. Make sure [Mage](https://magefile.org) is properly installed on your system.
|
2. Make sure [Mage](https://magefile.org) is properly installed on your system.
|
||||||
3. Clone the repo with `git clone https://code.vikunja.io/api` and switch into the directory.
|
3. Clone the repo with `git clone https://code.vikunja.io/api` and switch into the directory.
|
||||||
3. Run `mage build:build` in the source of this repo. This will build a binary in the root of the repo which will be able to run on your system.
|
4. Run `mage build:build` in the source of this repo. This will build a binary in the root of the repo which will be able to run on your system.
|
||||||
|
|
||||||
*Note:* Static ressources such as email templates are built into the binary.
|
*Note:* Static ressources such as email templates are built into the binary.
|
||||||
For these to work, you may need to run `mage build:generate` before building the vikunja binary.
|
For these to work, you may need to run `mage build:generate` before building the vikunja binary.
|
||||||
|
@ -38,7 +38,7 @@ More options are available, please refer to the [magefile docs]({{< ref "../deve
|
||||||
|
|
||||||
The code for the frontend is located at [code.vikunja.io/frontend](https://code.vikunja.io/frontend).
|
The code for the frontend is located at [code.vikunja.io/frontend](https://code.vikunja.io/frontend).
|
||||||
|
|
||||||
1. Make sure you have [pnpm](https://pnpm.io/) properly installed on your system.
|
1. Make sure you have [pnpm](https://pnpm.io/installation) properly installed on your system.
|
||||||
2. Clone the repo with `git clone https://code.vikunja.io/frontend` and switch into the directory.
|
2. Clone the repo with `git clone https://code.vikunja.io/frontend` and switch into the directory.
|
||||||
3. Install all dependencies with `pnpm install`
|
3. Install all dependencies with `pnpm install`
|
||||||
4. Build the frontend with `pnpm build`. This will result in a static js bundle in the `dist/` folder which you can deploy.
|
4. Build the frontend with `pnpm run build`. This will result in a static js bundle in the `dist/` folder which you can deploy.
|
||||||
|
|
Loading…
Reference in a new issue