monolit-local-app 2.0.3

Simple package for fast writing local sites and desktop apps, with html, css and javascript

Welcome to the Monolit 2.0.0 !!!

Starting with version 2.0.0, the approach to running JavaScript projects locally was completely changed. Versions 1.n.n__ focused on using pure HTML, CSS, and JavaScript. On the one hand, this could be seen as a plus—novices don't need to understand complex front-end technologies. On the other hand, this feature prevented the library's API from being used for commercial project development, as by early 2026, every company, from startups to big tech corporations, uses a wide range of JavaScript libraries for quick and easy front-end development.

But as mentioned earlier, this is no longer a problem. Almost the entire library code has been rewritten and adapted for standard JavaScript technologies such as React, Vue, and Angular. The essence of these frameworks is that they take the developer's source code and, through complex transformations (transpilation, compilation, etc.), place the compressed code into a group of files. Typically, these files are placed in the build folder, which can also contain a static folder for storing static CSS and JS files. Monolit then works with this compiled folder, not the developer's source code.

And in this part, the approach remains virtually unchanged. The library still requires specific paths (and now multiple paths will be required), and then, via the Flask API, the root file index.html will be returned to the URL localhost:3000/ (which can now be changed if desired). Subsequently, requests for the root HTML file will include all other files, including images, fonts, and static CSS and JS files.

How to install Monolit 2.0.0

The library can be installed using Python’s built-in package manager, pip. Simply type "pip install monolit_local_app" in your terminal, and all necessary packages will be automatically downloaded to your computer.

How to use Monolit 2.0.0

The library's usage hasn't changed dramatically. However, starting with version 2.0.0, the developer will be required to take slightly more responsibility for the process of including compiled files from the build folder. Previously, it was only necessary to specify the path to the folder containing the index.html file. Now, the developer must enter:

1. Full path to the folder build (compiled js project's folders)
2. Full path to the file index.html (often found in the root directory build)
3. Full path to the folder static (also often found in the root directory build)

You can run a JavaScript project from a local server in the following ways:

1. With function run:

import monolit_local_app as ml

if __name__ == "__main__":
    ml.run(
        "C:\\Users\\User\\Desktop\\Js\\react-app\\build",
        "C:\\Users\\User\\Desktop\\Js\\react-app\\build\\index.html",
        "C:\\Users\\User\\Desktop\\Js\\react-app\\build\\static"
        # ...
        # You can see all aruments list in function's doc-string
    )

The run function will simply start the server host at the given (default local) address.

2. With class LocalServer (OOP wrapper for run):

import monolit_local_app as ml

class App(ml.LocalServer):
    def process_request(self, request):
        return ml.jsonify({"code": 200})
                                       
    def process_path(self, path):
        return {
            "home": "index.html",
            "www": "index.html"
        }.get(path)
    
if __name__ == "__main__":
    App(
        "C:\\Users\\User\\Desktop\\Js\\react-app\\build",
        "C:\\Users\\User\\Desktop\\Js\\react-app\\build\\index.html",
        "C:\\Users\\User\\Desktop\\Js\\react-app\\build\\static",
    )()
#    ^
#    call object 'App' -> call function '__call__' -> call function 'run'

When objects inheriting from LocalServer are called, their attributes will be passed as arguments to the run function mentioned earlier.

The problems in Monolit 2.0.0

The main issue related to the 'preprocessing' parameter was fixed in version 2.0.2. Many bugs were also fixed and the JSON data exchange mechanism was optimized.