React Ape

• React Renderer to build UI interfaces using canvas/WebGL (TV and Hardware...

ReactCanvasWebGL
raphamorim/react-aperaphamorim.io/react-ape/react-ape

README

React Ape


React Renderer to build UI interfaces using Canvas/WebGL



Check the Docs (raphamorim.io/react-ape)


Join our Discord


DISCLAIMER: In experimental stage


React Ape is a react renderer to build UI interfaces using canvas/WebGL. React Ape was built to be an optional React-TV renderer. It's mainly a renderer focused on creating things for TV, PS5, PS4, Nintendo Switch, PS Vita, PS3 and low memory devices.

React Ape lets you build Canvas apps using React. React Ape uses the same design as React, letting you compose a rich UI from declarative components.

Understanding the Problem


tl;dr: Crafting a high-performance TV user interface using React (and also good to read: 60 FPS on the mobile web)

Crafting a high-performance TV user interface based on DOM is a real challenge, because of some reasons:

- Limited graphics acceleration
- Single core CPUs
- High Memory Usage for a common TV App

These restrictions make super responsive 60fps experiences especially tricky. The strategy is step in the renderer based on a hardware-accelerated canvas.

Examples


AppGithubApp
---------------------------------------
Photo[raphamorim/react-ape-photo-gallery](https://github.com/raphamorim/react-ape-photo-gallery)[Check
Movie[raphamorim/react-ape-movie-list-demo](https://github.com/raphamorim/react-ape-movie-list-demo)[Check
[Add------------------

API Usage


Install it using NPM or Yarn


  1. ``` sh
  2. # NPM
  3. npm install react-ape

  5. # Yarn
  6. yarn add react-ape
  7. ```

React Ape's API usage example


  1. ``` js
  2. import React, { Component } from 'react';
  3. import { Text, View } from 'react-ape';

  5. class ReactApeComponent extends Component {
  6.   render() {
  7.     return (
  8.       <View>
  9.         <Text>
  10.           Render this text on Canvas
  11.         </Text>
  12.         <Text>
  13.           You just use React Ape components like 'View' and 'Text',
  14.           just like React Native.
  15.         </Text>
  16.       </View>
  17.     );
  18.   }
  19. }
  20. ```

Demo on PS Vita


Demo on PS Vita

Demo on TV


Demo on TV

Testing it


React-Ape's CI uses macos-latest and since canvas renders a different output based on the operating system (node-canvas have rasterize fonts in different ways based on OS). It requires run the tests on the same OS. Please be aware that if you want to contribute using a different OS, make sure that you have Docker installed.

Roadmap


You can follow React-Ape development status here: Roadmap

Credits


A special thanks to Raphael Eckhardt for making the logo <3