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 Fosciafoscia/core
: core features of Foscia (models, actions, hooks, etc.)foscia/http
: abstract HTTP adapter implementationfoscia/object
: abstract raw objects (de)serializer implementationsfoscia/jsonapi
: JSON:API implementationfoscia/rest
: REST implementationfoscia/test
: Test utilities