https://github.com/aiursoftweb/kahla

Kahla is a cross-platform business messaging app. Mirror of https://gitlab.aiursoft.cn/aiursoft/kahla
https://github.com/aiursoftweb/kahla

angular business cross-platform desktop docker kahla messaging pwa

Last synced: about 1 month ago
JSON representation

Kahla is a cross-platform business messaging app. Mirror of https://gitlab.aiursoft.cn/aiursoft/kahla

• Host: GitHub
• URL: https://github.com/aiursoftweb/kahla
• Owner: AiursoftWeb
• License: other
• Created: 2017-10-16T07:37:51.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-05-02T06:35:35.000Z (about 2 months ago)
• Last Synced: 2025-05-15T20:05:22.413Z (about 1 month ago)
• Topics: angular, business, cross-platform, desktop, docker, kahla, messaging, pwa
• Language: C#
• Homepage: https://kahla.aiursoft.cn
• Size: 13.7 MB
• Stars: 418
• Watchers: 17
• Forks: 83
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Kahla

[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitlab.aiursoft.cn/aiursoft/kahla/-/blob/master/LICENSE)

[![Pipeline stat](https://gitlab.aiursoft.cn/aiursoft/kahla/badges/master/pipeline.svg)](https://gitlab.aiursoft.cn/aiursoft/kahla/-/pipelines)

[![Test Coverage](https://gitlab.aiursoft.cn/aiursoft/kahla/badges/master/coverage.svg)](https://gitlab.aiursoft.cn/aiursoft/kahla/-/pipelines)

[![NuGet version (Aiursoft.Kahla.Sdk)](https://img.shields.io/nuget/v/Aiursoft.Kahla.Sdk.svg)](https://www.nuget.org/packages/Aiursoft.Kahla.Sdk/)

[![ManHours](https://manhours.aiursoft.cn/r/gitlab.aiursoft.cn/aiursoft/kahla.svg)](https://gitlab.aiursoft.cn/aiursoft/kahla/-/commits/master?ref_type=heads)

[![Website](https://img.shields.io/website?url=https%3A%2F%2Fkahla.aiursoft.cn%2F)](https://kahla.aiursoft.cn)

[![Docker](https://img.shields.io/docker/pulls/aiursoft/kahla.svg)](https://hub.docker.com/r/aiursoft/kahla)

Kahla is a cross-platform business chat application. It is written in C# and TypeScript. It uses ASP.NET Core and Angular. It is a part of the Aiursoft project.

![overview](./screenshot.png)

## Try

Try a running Kahla [here](https://kahla.aiursoft.cn).

## Run manually

Requirements about how to run

1. Install [.NET 9 SDK](http://dot.net/) and [Node.js](https://nodejs.org/).

2. Execute `yarn install && yarn run build` at `./src/Aiursoft.Kahla.Frontend/` folder to install the dependencies.

3. Copy the `dist` content to `./src/Aiursoft.Kahla.Server/wwwroot/`.

4. Execute `dotnet run` to run the app.

5. Use your browser to view [http://localhost:5000](http://localhost:5000).

## Run in Microsoft Visual Studio

1. Open the `.sln` file in the project path.

2. Press `F5` to run the app.

## Run in Docker

First, install Docker [here](https://docs.docker.com/get-docker/).

Then run the following commands in a Linux shell:

```bash

image=aiursoft/kahla

appName=kahla

docker pull $image

docker run -d --name $appName --restart unless-stopped -p 5000:5000 -v /var/www/$appName:/data $image

```

That will start a web server at `http://localhost:5000` and you can test the app.

The docker image has the following context:

| Properties  | Value                           |

|-------------|---------------------------------|

| Image       | aiursoft/kahla                  |

| Ports       | 5000                            |

| Binary path | /app                            |

| Data path   | /data                           |

| Config path | /data/appsettings.json          |

## How to contribute

There are many ways to contribute to the project: logging bugs, submitting pull requests, reporting issues, and creating suggestions.

Even if you with push rights on the repository, you should create a personal fork and create feature branches there when you need them. This keeps the main repository clean and your workflow cruft out of sight.

We're also interested in your feedback on the future of this project. You can submit a suggestion or feature request through the issue tracker. To make this process more effective, we're asking that these include more information to help define them more clearly.