FOAM Framework

FOAM is an open-source modeling framework developed at Google.

With FOAM, you create a model, and FOAM can support many features based on it:

A (Javascript, Java or Swift) class, with diff(), clone(), and more.
Serialization to and from JSON, XML and protocol buffers.
Storage in many places, from IndexedDB to MongoDB.
Query parsers and a query optimizer.
Offline-friendly syncing, and many flavours of caching.
Customizable detail and summary views for HTML, Android and iOS.

FOAM combines these features with reactive programming, an MVC library, and a suite of view components for each platform. The result is a full-stack framework for building modern, cross-platform apps.

Try FOAM Live

Below is a FOAM model you can edit, and a list of FOAM features you can see live in your browser.

Try uncommenting the 'hometown' property. Or try changing the defaultValue for the gender property to 'F'.

FOAM can generate default views from a model. They can easily be customized, or replaced altogether.

FOAM can make a reasonable guess at a summary for a model - in this case the "name" property is chosen.

Tables in a variety of styles. This one is Material Design and supports column resizing and infinite scrolling.

diff() shows all the different properties between two objects of the same model. Try changing the Person's gender or age!

Any FOAM object can be serialized to JSON. Note that default values (eg. "gender" = "M") are omitted, saving space.

Any FOAM object can be serialized to XML. Note that default values (eg. "gender" = "M") are omitted, saving space.

FOAM can generate Java source code from a model, and includes a Java library for servers and Android.

FOAM can generate Swift source code from a model, and inludes a library for iOS development.

FOAM models data storage with the DAO, or Data Access Object. This single, high-level API works with many different storage backends.

Since the DAO API is small and high-level, it is easy to decorate a basic DAO with extra features.

Here's a list of some of the other features FOAM supports for every model.

dao.where(AND(
    GT(Person.AGE, 30),
    CONTAINS(Person.NAME, 'John')))
  .limit(10)
  .orderBy(Person.NAME)
  .select();
dao.put(myPerson);
dao.find(someID);

See the DAO Guide for more on the API.

Here are a few of the supported backends:

Lightning fast in-memory cache
LocalStorage and IndexedDB in the browser
MongoDB
Firebase
Postgres, SQLite and other SQL databases
JSON and XML files

clone()
copyFrom()
hashCode()
compareTo() and equals()
Observer support: Events for changes to a property, or any property
Query parsers (eg. age>=30, name:John)

FOAM includes DAO decorators that add these features to any DAO:

Caching (eager or lazy)
Offline sync
Client-server bridge
Journaling
Logging
Performance measurement

It's all the same API, so it's a one-line change to switch from fake data in memory to offline-ready syncing from a server into IndexedDB.

Fast apps fast

High-level

Compact

Fast

Try FOAM Live

Links

Sample Apps