About

What is Foscia?

Type safe, modular and intuitive API client.

Foscia is a simple, framework-agnostic, API client built with functional programming in mind. It can integrate with any Web app using JavaScript or TypeScript, and with any data source.

• Modular, highly extensible and fully tree-shakable thanks to functional programming
• Ready to use functions to integrate with any JSON:API and REST backends
• Type safe with generics typings on models, actions, etc.
• Framework-agnostic and dependency free (HTTP adapters are based on fetch API)
• Free and open-source under MIT license
• Coming soon: Fully tested and documented

info

Foscia is currently in alpha stage. It may contain bugs and the API may change. Please fill an issue to give your feedback.

Starting point

You may start to discover Foscia from different point of view.

• Install the package to use it immediately
• Get started using our simple guide about interacting with a JSON:API or REST API
• Live test through the Playground using a fake JSON REST API
• Check out examples built with Foscia to know if the API fits your needs

Structure of the package

• foscia/blueprints: pre-configured actions factories to quickly get started with Foscia
• foscia/core: core features of Foscia (models, actions, hooks, etc.)
• foscia/http: abstract HTTP adapter implementation
• foscia/object: abstract raw objects (de)serializer implementations
• foscia/jsonapi: JSON:API implementation
• foscia/rest: REST implementation
• foscia/test: Test utilities