docs: add a guide for running
All checks were successful
conventional pull request title check / conventional pull request title check (pull_request) Successful in 10s
actionlint check / actionlint check (pull_request) Successful in 16s
dotenv-linter check / dotenv-linter check (pull_request) Successful in 14s
conventional commit messages check / conventional commit messages check (pull_request) Successful in 16s
hadolint check / hadolint check (pull_request) Successful in 19s
GitLeaks check / GitLeaks check (pull_request) Successful in 21s
markdownlint check / markdownlint check (pull_request) Successful in 39s
Prettier check / Prettier check (pull_request) Successful in 40s
Stylelint check / Stylelint check (pull_request) Successful in 33s
ShellCheck check / ShellCheck check (pull_request) Successful in 44s
htmlhint check / htmlhint check (pull_request) Successful in 54s
yamllint check / yamllint check (pull_request) Successful in 41s
checkov check / checkov check (pull_request) Successful in 1m54s
Rust check / Rust check (pull_request) Successful in 13m29s
All checks were successful
conventional pull request title check / conventional pull request title check (pull_request) Successful in 10s
actionlint check / actionlint check (pull_request) Successful in 16s
dotenv-linter check / dotenv-linter check (pull_request) Successful in 14s
conventional commit messages check / conventional commit messages check (pull_request) Successful in 16s
hadolint check / hadolint check (pull_request) Successful in 19s
GitLeaks check / GitLeaks check (pull_request) Successful in 21s
markdownlint check / markdownlint check (pull_request) Successful in 39s
Prettier check / Prettier check (pull_request) Successful in 40s
Stylelint check / Stylelint check (pull_request) Successful in 33s
ShellCheck check / ShellCheck check (pull_request) Successful in 44s
htmlhint check / htmlhint check (pull_request) Successful in 54s
yamllint check / yamllint check (pull_request) Successful in 41s
checkov check / checkov check (pull_request) Successful in 1m54s
Rust check / Rust check (pull_request) Successful in 13m29s
This commit is contained in:
3
.env.dev
3
.env.dev
@@ -1,2 +1,5 @@
|
|||||||
|
# en-US or cs-CZ.
|
||||||
LANGUAGE_CODE=en-US
|
LANGUAGE_CODE=en-US
|
||||||
|
|
||||||
|
# Required only for mobile native client builds.
|
||||||
MOBILE_SERVER_URL=
|
MOBILE_SERVER_URL=
|
||||||
|
|||||||
59
readme.md
Normal file
59
readme.md
Normal file
@@ -0,0 +1,59 @@
|
|||||||
|
# Todo Baggins
|
||||||
|
|
||||||
|
A task management app tailored specifically to my personal GTD workflow.
|
||||||
|
|
||||||
|
## Running the web server
|
||||||
|
|
||||||
|
### Development
|
||||||
|
|
||||||
|
1. Copy `.env.dev` to `.env` and, if desired, edit it.
|
||||||
|
2. Create a symlink from `docker-compose.yaml` to `docker-compose-dev.yaml`.
|
||||||
|
3. Run the Docker compose stack with
|
||||||
|
|
||||||
|
```sh
|
||||||
|
docker compose up --build -d
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Enter the container shell with
|
||||||
|
|
||||||
|
```sh
|
||||||
|
docker compose exec -it app sh
|
||||||
|
```
|
||||||
|
|
||||||
|
5. Inside, start the development server with
|
||||||
|
|
||||||
|
```sh
|
||||||
|
dx serve --locked --addr 0.0.0.0 --port 8000
|
||||||
|
```
|
||||||
|
|
||||||
|
6. Once the build is finished, the web app will be accessible at
|
||||||
|
<http://localhost:8000>.
|
||||||
|
|
||||||
|
### Production
|
||||||
|
|
||||||
|
1. Copy `.env.dev` to `.env` and, if desired, edit it.
|
||||||
|
2. Create a symlink from `docker-compose.yaml` to `docker-compose-prod.yaml`.
|
||||||
|
3. Run the Docker compose stack with
|
||||||
|
|
||||||
|
```sh
|
||||||
|
docker compose up --build -d
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Once the build is finished, the web app will be accessible at the Docker
|
||||||
|
container, on port 80.
|
||||||
|
|
||||||
|
## Running the Android client
|
||||||
|
|
||||||
|
1. Copy `.env.dev` to `.env` and, if desired, edit it. Set the
|
||||||
|
`MOBILE_SERVER_URL` to the URL of the server which will be available as a
|
||||||
|
backend for the mobile client.
|
||||||
|
2. Start the build with
|
||||||
|
|
||||||
|
```sh
|
||||||
|
./scripts/export_android_bundle.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Once it is finished, the APK will be present at `bundle/android`.
|
||||||
|
4. Run the web server as described in a previous section and make it accessible
|
||||||
|
from the client running the mobile app at the URL specified in the
|
||||||
|
environment variable.
|
||||||
0
scripts/export_android_bundle.sh
Normal file → Executable file
0
scripts/export_android_bundle.sh
Normal file → Executable file
Reference in New Issue
Block a user