scalajs-react

Facebook's React on Scala.JS

Description

Lifts Facebook's React library into Scala.js and endeavours to make it as type-safe and Scala-friendly as possible.

Provides (opt-in) support for pure functional programming, with additional modules for Scalaz, Cats, and Monocle.

Comes utility modules extra and test, helpful for React in Scala(.js), rather than React in JS. Includes a router, testing utils, performance utils, more.

Programming language: Scala

License: Apache License 2.0

Tags: Web Frameworks     JavaScript     Scala.js     FP     React    

Latest version: v1.7.7

README

scalajs-react

Lifts Facebook's React library into Scala.js and endeavours to make it as type-safe and Scala-friendly as possible.

Provides (opt-in) support for pure functional programming, with additional modules for Cats, Cats Effect, and Monocle.

Comes with utility modules [extra](extra/) and [test](test/), helpful for React in Scala(.js), rather than React in JS. Includes a router, testing utils, performance utils, more.

Contents

• [Usage & Getting Started](doc/USAGE.md)
  • [Modules](doc/MODULES.md)
  • [VDOM](doc/VDOM.md)
  • [Hooks](doc/HOOKS.md)
  • [Refs](doc/REFS.md)
  • [IDE support](doc/IDE.md)
  • [The Callback class](doc/CALLBACK.md)
  • [React Context](doc/CONTEXT.md)
• Delving deeper
  • [Global Config](doc/CONFIG.md)
  • [Types](doc/TYPES.md)
  • [Interoperability](doc/INTEROP.md)
  • [Creating an Effect-Agnostic Library](doc/FX_AGNOSTICISM.md)
  • React SSR (Server-Side Rendering) on the JVM
  • [Functional programming](doc/FP.md)
• Scala-only Utilities
  • [Router](doc/ROUTER.md)
  • [Performance Management](doc/PERFORMANCE.md)
  • [Other](doc/EXTRA.md)
• [Testing](doc/TESTING.md)
• Live Examples & Demos
• [Changelogs](doc/changelog) — [v2.1.1 (Latest)](doc/changelog/2.1.1.md)

External Resources

• Tutorials / Blogs

  • Scala, React, and SSR
  • Scala.js and React: Building an Application for the Web

• Templates

  • chandu0101 / scalajs-react-template
  • ochrons / scalajs-spa-tutorial
  • TodoMVC example
  • Scala.js, React and ScalaCSS Boilerplate
  • 'Intro to React' tutorial transposed into scala.js

• Libraries

  • test-state - Integration/Functional/Property testing for scalajs-react.
  • scalajs-benchmark
  • chandu0101 / scalajs-react-components
  • payalabs / scalajs-react-bridge - Boilerplate free use of JS components
  • payalabs / scalajs-react-mdl - (Material Design Lite components)
  • cquiroz / scalajs-react-virtualized - Facade for react-virtualized
  • cquiroz / scalajs-react-clipboard - Facade for react-copy-to-clipboard
  • kinoplan / scalajs-react-material-ui - Material-UI components (+ Full Demo)
  • diode - library for managing application state, influenced by Flux and Elm

• Open Source Projects, which are using scalajs-react

  • Mr. Boilerplate - good example of how to properly manage state in scalajs-react
  • scala-weather-app - Yet another weather application, based on Scala.js, scalajs-react and Playframework
  • scalafiddle-editor - Web user interface for ScalaFiddle https://scalafiddle.io
  • scastie - An interactive playground for Scala https://scastie.scala-lang.org

Requirements:

• React ≥ 17
• Scala ≥ 2.13
• Scala.JS ≥ 1.10

Support:

If you like what I do —my OSS libraries, my contributions to other OSS libs, my programming blog— and you'd like to support me, more content, more lib maintenance, please become a patron! I do all my OSS work unpaid so showing your support will make a big difference.