Frequently Asked Questions

Getting started

Does Finsemble work on OSX? Linux?

  • Currently, Finsemble only supports the Windows operating system for production use but development is also supported on OSX and Linux. To get the Finsemble seed project to work on OSX/Linux, Assimilation must be disabled. To disable Assimilation, edit configs/application/config.json and change betaFeatures.assimilation.enabled to false.

Can I integrate our legacy Java/.Net/C# apps into Finsemble?

  • Finsemble is intended to integrate different apps and have them run using Finsemble as the central hub. We call this process Assimilation. For complete details on this process, you can read our tutorial for Assimilation.

How can I control native JavaScript window functionality?

  • We provide a file that contains a set of overrides that will convert HTML5 window actions to corresponding Finsemble actions. It can be found here: src-built-in/preloads/nativeOverrides.js Overrides must be specified for each component via a "preload" script. You do this by adding the preload to the component config. Full instructions are found inside nativeOverrides.js.

How can our legacy Java/.Net/C# communicate with our HTML5 components?

  • Our Linker Client was initially built to allow for data synchronization between two HTML5 components. However, our RPC Service allows native applications to signal that they are participating in a linker group via the Linker Client, so legacy Java components can communicate with HTML5 components.

I'm developing in Windows 8.1, but I'm having problems. What's up? If you are using Windows 8.1, make sure you disable the Gulp watchers. Due to some idiosyncrasy in node or Gulp, the watchers break the entire process. We recommend that you upgrade to Windows 10 if feasible. The watchers really increase developer productivity.

Release cycle

What is your release cycle?

  • Finsemble operates on a biweekly (that is to say, every two weeks) lean software development life cycle. We prioritize features, but don't assign delivery dates.

How do I submit a bug report or feature request?

  • If you encounter bugs with Finsemble, you can reach out to for support. If you have a perspective on something that would be worthwhile for your organization, touch base with us via

UI options

What are the UI options for my Finsemble application?

  • We've created production-ready UI components called presentation components. These were built using React controls, which are discrete UI elements. You can use these React controls to extend our sample components, or they can be completely replaced with components of your own devising. We'll always support the controls we used to build our presentation components, but you have the ability to go in new directions and completely tailor your application's user experience.

Can I disable the toolbar in my Finsemble application?

  • Sure. We included the built-in presentation components (e.g., linker panel, toolbars, dialogs) in the seed project so you'd have an example of the sort of UI that an end user might expect. However, we kept them in the source directory so you'd have the ability to change or remove them. The toolbar is disabled by removing its definition from the systemComponents.json. If you remove the "Toolbar" property from that file, the toolbar will no longer show up.

Developing with Finsemble

Why shouldn't I just build an application from scratch?

  • Essentially, Finsemble allows your developers to focus on the parts of the application that bring value to your organization while we do the plumbing necessary to get the application to work. Finsemble accelerates your development cycle and time to market drastically. By building on the Finsemble framework, it takes comparatively little development work to build an application of interlocking components. This is because Finsemble comes with a pre-built infrastructure: it comes (nearly) assembled out of the box, batteries included. That said, Finsemble affords you total freedom in creating exactly the application you want for your organization. Additionally, Finsemble is built by developers for developers. Windows only need to be aware of data objects, not necessarily other windows, so cross app communication is simple. The Distributed Store allows windows to share and sync data in real time. Finally, the Central Logger simplifies debugging an application built across multiple windows and services.

How do I use Finsemble with Typescript?

  • Finsemble is injected into components (web pages) launched using Finsemble as the FSBL object. We do not currently have type script definitions for Finsemble, so you will need to declare the FSBL object to have type any to satisfy Typescript. This will allow your Typescript code to compile, and the value of the variable will be set to the FSBL object when the component is loaded inside Finsemble. This is done like so:
let FSBL : any;
  • For applications that you want to work outside of Finsemble, you can then check whether the FSBL object is defined before calling Finsemble methods, like this:
if (typeof FSBL !== "undefined") {
   // code that uses the FSBL object

Can I use Grunt instead of Gulp to build my own components?

  • Sure! It's possible to run Grunt tasks from Gulp. You can follow the instructions from gulp.js here.

Is it possible to switch to a different storage engine?

  • By default, Finsemble stores data locally. The Storage Client API uses the Storage Adapter to save and retrieve data from localStorage. However, the Storage Adapter can be updated to utilize another type of data store, e.g., a remote database. You simply need to adjust the adapter so that it interfaces the Storage Client API with that data store. More information about how you can do this can be found in our Storing Data tutorial.

Can my application start on operating system startup?

  • Absolutely! Both developers and users can make it so Finsemble launches at start-up. Developers can utilize OpenFin, on which Finsemble is built, to start their applications on system start-up. In your application's manifest file (in our seed, it's in configs/openfin/manifest-local.json), edit the shortcut property. You'll need to modify the target property. Simply add "automatic-start-up" to the array and your application will launch on start-up. It looks like this:
    "shortcut": {
        "company": "ChartIQ",
        "description": "ChartIQ Local",
        "icon": "http://localhost:3375/components/samples/src/assets/img/Finsemble_Taskbar_Icon.ico",
        "name": "ChartIQ - LOCAL",
        "target": [
        "force": false,
        "startMenuRootFolder": "ChartIQ Local"

Why don’t I see heartbeat messages in the Finsemble’s log?

  • Internal heartbeat messages tend to be frequent, so they clutter up logging and make debugging difficult. Therefore, the Logger Client will filter out (i.e., not send to Central Logger) any log messages with the substring "heartbeat."

If you haven’t yet found the answer for your question please feel free to email us. We'd be happy to help you.