DanceSmile / Kahla.App

Kahla is a cross-platform business messaging app.

Kahla

Welcome to Kahla. Kahla is a cross-platform business messaging app. Kahla also achieved one target to use one copy of code and target all platforms.

Kahla currently targets Windows, Linux, macOS, Android, iOS, and Windows Mobile.

Kahla is built with Angular 5 and typescript. And Kahla Server is built with ASP.Net Core.

For more document about Kahla project and Kahla API, please view document here.

How to develope

Before starting

To develope Kahla, you need to install the following components:

• Git
• Nodejs and npm

We strongly suggest using Visual Studio Code to develope this project.

Use Visual Studio Code to open the directory directly.

How to run

How to run in browser

Excute following command in the root directory of this repository to restore all dependencies.

npm install

Excute following command to run and start a debug server at localhost:8001.

npm start

How to run as desktop app

Currently we are using Electron to target Windows, Mac and Linux platform.

Supports Windows 7+, Linux and macOS 10.9+.

npm run electron

How to run as mobile app

Currently we are using Apache Cordova to target Android and iOS platform.

Before running, please prepare your Android development environment and an Android device.

Run the following command to install Apache Cordova.

npm i -g cordova
cordova platform add android

Run the following command to run on a Android device.

npm run android

How to publish

How to publish to a web server

ng build --prod

If you want to create Chinese version, please use the following command instead.

ng build --prod --local zh --i18n-file ./src/message.zh.xlf

How to publish as Electron production version

Please view here for Electron distribution document.

Download the prebuilt electron here.

Run:

ng build --base-href ./ --prod

And get the built production Kahla app.

Run:

mv ./www/electron.js ./www/index.js

To rename electron.js to index.js.

Run:

cp ./package.json ./www/

To copy that package.json to www.

Run:

npm run pack

To pack the app.

Next, the folder containing your app should be named app and placed in Electron's resources directory as shown in the following examples. Note that the location of Electron's prebuilt binaries is indicated with electron/ in the examples below.

electron/resources/app
├── package.json
├── main.js
└── index.html

Then run electron (electron.exe on Windows).

How to publish as Cordova production version

Please view here for Cordova distribution document.

Document

For more info please view Kahla Wiki

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 have 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 personal workflow cruft out of sight.

We're also interested in your feedback for 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.