relay README

The project's README from github.com/facebook/relay. As one markdown file: README.md.

Relay · GitHub license npm version

Relay is a JavaScript framework for building data-driven React applications.

See how to use Relay in your own project.

Example

The relay-examples repository contains an implementation of TodoMVC. To try it out:

git clone https://github.com/relayjs/relay-examples.git
cd relay-examples/todo
yarn
yarn grats
yarn relay
yarn dev

Then, just point your browser at http://localhost:5173.

Contribute

We actively welcome pull requests, learn how to contribute.

Users

We have a community-maintained list of people and projects using Relay in production.

License

Relay is MIT licensed.

Thanks

We'd like to thank the contributors that helped make Relay in open source possible.

The open source project relay-hooks allowed the community to experiment with Relay and React Hooks, and was a source of valuable feedback for us. The idea for the useSubscription hook originated in an issue on that repo. Thank you @morrys for driving this project and for playing such an important role in our open source community.

Thank you for helping make this possible!

relay (facebook/relay)

Searching Database…

19K ·GitHub
Что это такое?Relay — это JavaScript-фреймворк для создания приложений на React, построенных вокруг данных: вы декларативно описываете через GraphQL, какие данные нужны вашим компонентам, а Relay сам решает, как и когда их загрузить.
Чем работа с данными отличается от привычного подхода в React?Она декларативная и хранится рядом с кодом: вместо императивных вызовов к хранилищу данных вы описываете требования к данным прямо рядом с теми частями интерфейса, которые их используют. Запросы и UI не разъезжаются по коду, и работать с ними проще.
Как попробовать в деле?Склонируйте репозиторий relay-examples — там есть реализация TodoMVC, которую можно запустить и открыть в браузере. В README также есть ссылки на документацию по использованию Relay в своём проекте.
Мне нужен GraphQL-бэкенд, чтобы этим пользоваться?Да. GraphQL — это контракт и для чтения, и для записи: требования к данным вы описываете GraphQL-запросами, а изменяете данные через GraphQL-мутации. То есть приложение общается с GraphQL API.
Что я получу для мутаций?Автоматическую согласованность данных, оптимистичные обновления и обработку ошибок — для мутаций и на клиенте, и на сервере, и всё это выражается в виде GraphQL-мутаций.
Relay реально используют в продакшене?Да — в репозитории ведётся поддерживаемый сообществом список людей и проектов, которые используют Relay в продакшене, а сам проект живёт на GitHub с 2015 года.
На GitHub в качестве основного языка указан Rust — Relay написан на Rust или на JavaScript?Код, который вы устанавливаете и используете, — это JavaScript: npm-пакеты, подключаемые к React-приложениям через Babel. Rust же GitHub показывает как основной язык репозитория — это связано с его компилятором.
Он помогает сократить сетевой трафик?Да — Relay собирает ваши запросы в эффективные сетевые запросы и загружает только те данные, которые приложению действительно нужны.
What are similar projects?hyperapp, gatsby, riot, vuex, nuqs, marked, formily, marko
Creator
facebook
Size
7 GB
Stars
19K
Age
11y
Commits · 90 Days