ComilaJS

Synopsis

This library aims to provide a lightweight Common Language Infrastructure for web applications without the need for browser plugins or server-side execution.

Motivation

This library was developed as a standalone dependency for a commercial project which enables regular .Net applications to run as responsive web applications without having to rewrite them completely.

Installation

Download the latest stable release here
Extract the contents of the archive and copy the contents of the dist folder to your project's public assets folder.

Usage

Include the comila.min.js script on the page
Run an application by invoking comilajs.run('path/to/application.exe')

<!DOCTYPE html>
<html>
  <head>
    <title>Application Name</title>
    <meta charset="utf-8"/>
    <script src="assets/comila.min.js"></script>
  </head>

  <body>
    <script>
      comilajs.run('path/to/application.exe');
    </script>
  </body>
</html>

Platform Invocation

An application must use P/Invoke in order to access the JavaScript engine in the browser. This is achieved by targeting javascript.dll.

Limitations

This library provides only the virtual execution system (VES) and as such, it cannot directly run applications which rely on classes from mscorlib. However, custom implementations of these classes can be provided by the applications.

Contributing

Fork the repository
Create your feature branch: git checkout -b feature/my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin feature/my-new-feature
Submit a pull request

License

This library is licensed under the GNU Lesser General Public License - see the LICENSE file for details.

danitso/comilajs