ReactCLI is a react renderer for the command line. All of the benefits of React, right in your terminal.
import ReactCLI, { Section } from "react-cli-renderer";
import React from "react";
import chalk from "chalk";
class MyReactCLIApp extends React.Component {
state = {
step: 0
};
componentDidMount() {
setTimeout(() => this.setState({ step: 1 }), 1000);
setTimeout(() => this.setState({ step: 2 }), 2000);
setTimeout(() => this.setState({ step: 3 }), 3000);
}
render() {
return (
<Section border={{ horizontal: "*", vertical: "*" }} align="center">
My {chalk.blue("New")} {chalk.magenta("ReactCLI App")} ๐
<Section horizontal>
<Section align="center">
{this.state.step >= 1 ? chalk.green("โ๏ธ") : "โฏ"} Step 1<br />
{this.state.step >= 2 ? chalk.green("โ๏ธ") : "โฏ"} Step 2<br />
{this.state.step >= 3 ? chalk.green("โ๏ธ") : "โฏ"} Step 3
</Section>
<Section border={{ horizontal: "-", vertical: "|" }} align="center">
Number of steps done:{" "}
{chalk.bold.magenta(this.state.step.toString())}
</Section>
</Section>
</Section>
);
}
}
ReactCLI(<MyReactCLIApp />);
note: this example uses the "@babel/preset-env", "@babel/preset-react" babel presets, and "@babel/plugin-proposal-class-properties" plugin
yarn add react react-cli-renderer
npm install --save react react-cli-renderer
note: You can use react-cli-renderer without babel, but you'll most likely want to write components using JSX.
ink components do not work out-of-the-box with react-cli. However, if you're interested in re-using existing ink components, check out ink-on-reactcli for more information.
ReactCLI is analogous to ReactDOM or ReactNative. It just renders any updates dictated by React and the React reconciler to the command line. This means that you get all of the core features of React for free, like stateful components, context, refs, etc - in addition to being able to use third party libraries for things like state management. It also provides a couple core components that are useful for building out command line interfaces.
ReactCLI provides two components for building command line interfaces.
-
Section A new section is denoted by
Section
. A section can either be vertical, or horizontal. The children of a section can be a mix of text, or more sections. A section can also align text left, right, or center.<Section horizontal> <Section>Column 1</Section> <Section>Column 2</Section> </Section>
-
break Break components allow you to define columns and/or rows within a section (as opposed to using nested sections).
<Section> Row 1<br /> Row 2 </Section>
if you're using ReactCLI and want to add your project to this list, feel free to submit a PR!
Contributions welcome!