tasks-app

KO | EN

gitlite — search

#javascript #react #ai #android #linux #docker #macos #kubernetes #vue #awesome-list #security #ios #mcp #open-source

(★ 12)

Tasks App - Modular Monolith

tasks-app Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Tasks App - Modular Monolith

A simple single binary task management app, built as a modular monolith. The app supports single-process and multi-process setups. In the multi-process setup, each instance is configured to run a subset of the modules.

## Tech Stack

| TECHNOLOGY                                 | DESCRIPTION                                   |
| ------------------------------------------ | --------------------------------------------- |
| [NATS](https://nats.io/)                   | Messaging, WebSockets, KV Store, Object Store |
| [PostgreSQL](https://www.postgresql.org/)  | Database                                      |
| [ZITADEL](https://zitadel.com/)            | Identity and Access Management (IAM)          |
| [Terraform](https://www.terraform.io/)     | Infrastructure Automation                     |
| [Bash](https://www.gnu.org/software/bash/) | Scripting                                     |
| [Go](https://go.dev/)                      | Programming Language                          |
| [htmx](https://htmx.org/)                  | Web Technology                                |
| [Hyperscript](https://hyperscript.org/)    | Frontend Scripting Language                   |

## Infrastructure Setup

The infrastructure is built on top of the Azure K3s setup provided in the following GitHub repository:

https://github.com/heikkilamarko/azure-k3s-demo

### Hosts Configuration

To enable local name resolution for the services, add the following entries to your `/etc/hosts` file, replacing `<IP_ADDRESS>` with the external IP of your K3s ingress controller or load balancer:

```
<IP_ADDRESS> zitadel.test
<IP_ADDRESS> smtp4dev.test
<IP_ADDRESS> tasks-app.test
```

### NATS Configuration

Follow the instructions in [infra/nats](infra/nats) to configure NATS.

### PostgreSQL Configuration

Follow the instructions in [infra/postgresql](infra/postgresql) to configure PostgreSQL.

### ZITADEL Configuration

Follow the instructions in [infra/zitadel](infra/zitadel) to configure ZITADEL.

## Application Deployment

### Build the Application

```bash
./ci.sh <image_tag>
```

### Deploy as a Single Binary

```bash
./cd.sh <image_tag> k8s/overlays/single
```

```bash
./cleanup.sh <image_tag> k8s/overlays/single
```

### Deploy as Microservices

```bash
./cd.sh <image_tag> k8s/overlays/micro
```

```bash
./cleanup.sh <image_tag> k8s/overlays/micro
```

## Application

Access the Tasks application at:

https://tasks-app.test/

### Example Users

| Username  | Initial Password |
| --------- | ---------------- |
| `johndoe` | `S3c_r3t!`       |
| `janedoe` | `S3c_r3t!`       |

### smtp4dev Web UI

Inspect outgoing application emails such as password change notifications or task expiration alerts using the smtp4dev web interface:

https://smtp4dev.test/

tasks-app

tasks-app Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

tasks-app

tasks-app Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README