README.md

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 and test, helpful for React in Scala(.js), rather than React in JS. Includes a router, testing utils, performance utils, more.

Contents

• Usage & Getting Started
  • Modules
  • VDOM
  • Hooks
  • Refs
  • IDE support
  • The Callback class
  • React Context
• Delving deeper
  • Global Config
  • Types
  • Interoperability
  • Creating an Effect-Agnostic Library
  • React SSR (Server-Side Rendering) on the JVM
  • Functional programming
• Scala-only Utilities
  • Router
  • Performance Management
  • Other
• Testing
• Live Examples & Demos
• Changelogs — v2.1.1 (Latest)

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.