facebookarchive/flux

Flux is an application architecture (a pattern for organizing how data flows through an app) originally created by Facebook for building user interfaces with React. It is now archived, meaning no further development will happen, and the project recommends newer alternatives. The core idea behind Flux is "unidirectional data flow," which means data always moves in one direction through your app rather than bouncing back and forth unpredictably. The pattern has four main parts: Actions (events that describe something happening, like a user clicking a button), a Dispatcher (a central hub that receives actions and passes them to the right places), Stores (where your app's data and business logic live), and Views (the UI components that display data from the Stores and trigger new Actions). By keeping data flowing in one direction, it becomes easier to understand and debug how your app's state changes over time. Flux is less a rigid framework and more a conceptual pattern. The repository provides a Dispatcher module and some utility classes to help you implement the pattern, but does not dictate the full structure of your app. It is written in JavaScript and was installed via npm. The README includes code examples showing how to create a Store using the provided ReduceStore base class, which handles state updates based on incoming actions. Since the project is archived, it is mainly of historical interest today. If you are starting a new project, the README directs you toward alternatives like Redux, MobX, Recoil, Zustand, or Jotai.