/Bridge

Write modern mobile and web apps in C#. Run them anywhere in JavaScript with Bridge.NET.

Primary LanguageC#Apache License 2.0Apache-2.0

Bridge.NET - C# to JavaScript Compiler

Build status Build Status NuGet Status Join the chat at https://gitter.im/bridgedotnet/Bridge

Bridge.NET is an open source C#-to-JavaScript Compiler.

Compile your C#...

Console.WriteLine("Hello, World!");

into JavaScript

console.log("Hello, World!");

TL;DR

Getting Started

A great place to start if you're new to Bridge.NET is reviewing the Getting Started Knowledge Base article.

The easiest place to see Bridge in action is Deck.

Sample

The following code sample demonstrates a simple App.cs class that will run automatically on page load and prompt with an alert message.

public class Program
{
    public static void Main()
    {
        Console.WriteLine("Hello World!");
    }
}

The C# class above will be compiled into JavaScript and added to /Bridge/ouput/demo.js within your project. By default, Bridge will use the Namespace name as the file name. In this case: demo.js. There are many options to control the output of your JavaScript files, and the Attribute Reference is an important Knowledge Base article to review.

Bridge.assembly("Demo", function ($asm, globals) {
    "use strict";

    Bridge.define("Demo.Program", {
        $main: function () {
            Bridge.Console.log("Hello World!");
        }
    });
}); 

Installation

A full list of installation options available at bridge.net/download/, including full support on Windows, Mac OS and Linux for Visual Studio Code and Mono Develop.

Bridge for Visual Studio

If you're using Visual Studio, the best way to get started is by adding the Bridge.NET for Visual Studio extension.

From within Visual Studio, go to the Tools > Extensions and Updates....

Visual Studio Extensions and Updates

From the options on the left side, be sure to select Online, then search for Bridge. Clicking Download will install Bridge for Visual Studio. After installation is complete, Visual Studio may require a restart.

Bridge for Visual Studio

After installation, you will have a new Bridge.NET project type. When creating new Bridge enabled projects, select this project type.

NuGet

Another option is installation of Bridge into a new C# Class Library project using NuGet. Within the NuGet Package Manager, search for Bridge and click to install.

Another NuGet option is installing Bridge via the NuGet Command line. Run the following command:

Install-Package Bridge

More information regarding Nuget package installation for Bridge is available in the Knowledge Base.

Contributing

Interested in contributing to Bridge? Please see CONTRIBUTING.md.

We also flag some Issues as up-for-grabs. These are generally easy introductions to the inner workings of Bridge, although are items we just haven't had time to implement. Your help is always appreciated.

Testing

Bridge is continually tested and the full test runner is available at http://testing.bridge.net/.

Credits

Bridge is developed by the team at Object.NET. Frameworks and Tools for .NET Developers.

License

Apache License, Version 2.0

Please see LICENSE for details.