Skip to content

blakemcbride/Kiss

Repository files navigation

KISS Web Application Full Stack Framework

The KISS Framework is a Java-based, full-stack application development framework for developing web-based business applications. KISS can also be used to build command-line utilities, and, in conjunction with Electron, desktop applications that are portable to Windows, Mac, and Linux.

Please see the main web site for a more detailed description at https://kissweb.org

This project is in full release status and not a beta. It is being used in production.

Home for the code is at: https://github.com/blakemcbride/Kiss

For build and usage instructions see the manual at manual/man/index.html Or, the user manual can be read online at Kiss Online User Manual

Public discussion and support is available at Kiss Support

Training Videos

A 6-part training series on KISS is at:

An article about KISS is available at The KISS Web Development Framework

Another article about KISS is available at Developing REST Microservices Simply

Quick Start

Presuming you have the Java JDK (tested with Java 8, 11, and 17), GIT, and an Internet connection, you can run the following commands to download, install, configure, and run Kiss, tomcat, and the required JAR files:

Be sure the JAVA_HOME and JRE_HOME environment variables are set correctly!

Linux, Mac, BSD, etc.

git clone https://github.com/blakemcbride/Kiss.git
cd Kiss
./bld develop

Windows

git clone https://github.com/blakemcbride/Kiss.git
cd Kiss
bld develop

In either environment, you can then go to http:https://localhost:8000 within your browser to use the system. After that, both the front-end and the back-end code can be changed while the system is running. No need for additional compiles or deploys.

Documentation

The system comes with (essentially) three manuals as follows:

User Manual (HTML): manual/man/index.html

User Manual (PDF): Kiss.pdf

Front-end API: manual/jsdoc/index.html

The back-end JavaDoc must be built by you. This can be done by typing:

./bld javadoc               [Linux, Mac, BSD, etc.]
    -or-
bld javadoc                 [Windows]

You then get: work/javadoc/index.html

Support

Commercial support is available from [email protected]

Please help fund this project at https://www.gofundme.com/kissweb