Git Product home page Git Product logo

react-terminal's Introduction

๐Ÿš€ React component that renders a Terminal ๐Ÿ–ฅ

Features โ€ข Installation โ€ข Usage โ€ข Props โ€ข Report a bug

Terminal png

Features

  • Mobile support. ๐Ÿ“ฑ
  • Customizable commands, prompt and error message. โœ…
  • Support callbacks(async/non-async) for commands. ๐Ÿ”„
  • Command history using arrow up and down. ๐Ÿ”ผ
  • Support for copy/paste. ๐Ÿ“‹
  • In-built themes and support to create more. ๐Ÿš€

Installation

Install package with NPM or YARN and add it to your development dependencies:

npm install react-terminal

OR

yarn add react-terminal

Usage

import { ReactTerminal } from "react-terminal";

function App(props) {
  // Define commands here
  const commands = {
    whoami: "jackharper",
    cd: (directory) => `changed path to ${directory}`
  };

  return (
    <ReactTerminal
      commands={commands}
    />
  );
}

Also make sure to wrap the main mountpoint around the TerminalContextProvider. This retains the state even when the component is unmounted and then mounted back:

import { TerminalContextProvider } from "react-terminal";

ReactDOM.render(
  <TerminalContextProvider>
    <App/>
  </TerminalContextProvider>,
  rootElement
);

Creating custom themes

The component comes with few in-built themes: light, dark, material-light, material-dark, material-ocean, matrix and dracula. You can also create custom themes by passing themes parameter in props, as follows:

<ReactTerminal
  commands={commands}
  themes={{
    "my-custom-theme": {
      themeBGColor: "#272B36",
      themeToolbarColor: "#DBDBDB",
      themeColor: "#FFFEFC",
      themePromptColor: "#a917a8"
    }
  }}
  theme="my-custom-theme"
/>

Props

name description default
welcomeMessage A welcome message to show at the start, before the prompt begins. Value can be either a string or JSX null
prompt Terminal prompt >>>
commands List of commands to be provided as a key value pair where value can be either a string, JSX/HTML tag or callback null
errorMessage Message to show when unidentified command executed, can be either a string, JSX/HTML tag or callback "not found!"
enableInput Whether to enable user input true
showControlBar Whether to show the top control bar true
showControlButtons Whether to show the control buttons at the top bar of the terminal true
theme Theme of the terminal "light"
themes Themes object to supply custom themes null
defaultHandler Default handler to be used (if provided) when no commands match. Useful when you don't know list of commands beforehand/want to send them to server for handling. null

In-built commands

command description
clear clears the console

Report a bug

If you found a bug in this library, please file an GitHub issue here.

react-terminal's People

Contributors

dependabot[bot] avatar bony2023 avatar github-actions[bot] avatar 0notapplicable0 avatar raaaahman avatar benmneb avatar jay-jlm avatar harish-m-2003 avatar sorkinl avatar bitcoinbrisbane avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.