sdk

Foliage SDK

Foliage is a collaborative application platform built upon a distributed graph database, providing a unified and extensible environment for effortless automation, cross-domain connectivity, and high-performance, edge-friendly runtimes.

Table of Contents

• Introduction
• Core Concepts
  • Abstract
  • Features
• Getting Started
  • Installation
  • Running Tests
  • Customization
• Development
  • Working with the SDK
• Technology Stack
• Roadmap
• References
• License
• Contribution

Introduction

Foliage is an open-source collaborative platform that uses a distributed graph database, offering a unified, extensible environment for automation, cross-domain connectivity, and high-performance, edge-friendly runtimes. It provides a robust foundation for IoT solutions, automation workflows, and edge computing applications.

Core Concepts

Abstract

Foliage introduces abstraction, where knowledge about complex systems converges into a unified space, promoting transparent understanding and blurring the boundary between system models and the system itself.

Features

Foliage promotes transparency, consistency, and clarity among system components by consolidating knowledge from diverse domains into a unified space. It reveals hidden dependencies, simplifying system evaluation and relationship management.

Click here to see all features.

Getting Started

Installation

To begin using Foliage, clone the repository:

git clone https://github.com/foliagecp/sdk.git

For detailed installation instructions and prerequisites, visit the official documentation.

Running Tests

Foliage provides a set of test samples to help you get familiar with the platform. Follow these steps to run them:

1. Navigate to tests:

cd tests

2. Build the tests runtime:

docker-compose build

3. Modify the .env file:

Customize the test environment by editing the .env file. For the basic test, find it at ./basic/.env.

4. Start the tests:

docker-compose up -d

To select a different test sample, set the TEST_NAME environment variable before running docker-compose up -d. The basic test sample starts by default.

5. Stop and clean up:

When you're done testing, stop and clean up the environment:

docker-compose down -v

Customization

Explore available test samples and customize them to gain insights into Foliage's development principles. Refer to basic test sample documentation.

For statefun logic definition, consider using plugins like JavaScript.

Development

Working with the SDK

Use SDK To develop applications with Foliage:

go get github.com/foliagecp/sdk

• Learn to work with the graph here
• Explore Foliage's JSON Path Graph Query Language (JPGQL) here
• Find out how to write your own application here
• Measure performance with guidance here

Technology Stack

Foliage relies on a versatile technology stack that includes:

• Backend
  • Jetstream NATS
  • Key/Value Store NATS
  • WebSocket NATS
  • GoLang
  • JavaScript (V8)
• Frontend
  • React
  • TypeScript/JavaScript
  • WebSocket
• Common
  • Docker
  • Docker Compose

Learn more about our technology choices.

Roadmap

Check out our Roadmap for more upcoming features and enhancements.

References

• Glossary
• Conventions

License

Unless otherwise noted, the Foliage source files are distributed under the Apache Version 2.0 license found in the LICENSE file.

Contribution

Foliage welcomes contributions from the open-source community. Join us in building a collaborative application platform that empowers developers worldwide!