Farfetched

The advanced data fetching tool for web applications

• Transport/protocol/backend agnostic (REST, GraphQL, promises, whatever!)
• Framework-agnostic (React, Solid, Vue, Svelte, Angular, whatever!)
• Declarative — expresses the logic of a computation without describing its control flow
• First class TypeScript support out of the box
• Focused to improve both developer and user experiences

Continue reading about Farfetched in the documentation. It covers integration with the most popular UI-frameworks (such React and Solid), error handling, dependent queries, advanced contracts and other great tools.

Repository contains several showcases of Farfetched usage. To start playing with them, clone repository and run pnpm install && pnpm run --filter NAME dev in the root directory, where NAME is the name of the showcase.

If you want to contribute to Farfetched, please read the CONTRIBUTING.md file first.

• clone repo
• install deps via pnpm install
• make changes
• make sure that your changes is passing checks:
  • run tests via pnpm run -r test:run
  • try to build it via pnpm run -r build
  • format code via pnpm run format:check
• fill in changes via pnpm changeset
• open a PR
• enjoy 🎉

Releases of Farfetched are automated by changesets and GitHub Actions. Your only duty is creating changeset for every PR, it is controlled by Changes-action.

After merging PR to master-branch, Version-action will update special PR with the next release. To publish this release, just merge special PR and wait, Release-action will publish packages.

Copy-paste packages/atomic-router directory, rename it to the package name. Then, update package.json, README.md and vite.config.ts files. Then, delete CHANGELOG.md file and any other files that are not needed in the new package.

Fancy generator will be added in the future.

Farfetched powered by Aviasales.

Special thanks to all contributors and especially Alexandr for endless patience during our debates about this library.

Some of external libraries were inlined to Farfetched due to bundle size and custom features requirements:

• https://github.com/effector/patronum
• https://github.com/smelukov/nano-equal
• https://github.com/DirtyHairy/async-mutex