0.0.17 โข Published 4 months ago
react-terminal-plus v0.0.17
react-terminal-plus
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 through keyboard and browser's context. ๐
- Cancel running command using
Ctrl + C
. โ - In-built themes and support to create more. ๐
- Clear the terminal with
clear
command or usingCtrl + L
. ๐งน - Local storage support for the command history. ๐พ
- Full TypeScript support. ๐
Installation
npm install react-terminal-plus
OR
yarn add react-terminal-plus
OR
pnpm i react-terminal-plus
Usage
import { TerminalContextProvider, ReactTerminal } from "react-terminal-plus";
function App(props) {
// Define commands here
const commands = {
whoami: "jackharper",
cd: (directory) => `changed path to ${directory}`,
};
return (
<TerminalContextProvider>
<ReactTerminal commands={commands} />
</TerminalContextProvider>
);
}
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 |
cls | clears the console |
In-built shortcuts
shortcut | description |
---|---|
ctrl + c | copy OR cancel running command if there is no selected text |
ctrl + v | paste |
ctrl + l | clear the console |
Development
See .github/CONTRIBUTING.md
, then .github/DEVELOPMENT.md
.
Thanks! ๐ช
Credits
This repository resulted from a react-terminal
fork, and as such we would like to thank all its contributors for creating such an amazing piece of OS software. ๐
0.0.16
4 months ago
0.0.17
4 months ago
0.0.12
8 months ago
0.0.13
8 months ago
0.0.14
8 months ago
0.0.15
7 months ago
0.0.11
10 months ago
0.0.10
10 months ago
0.0.9
10 months ago
0.0.8
10 months ago
0.0.7
10 months ago
0.0.6
10 months ago
0.0.5
11 months ago
0.0.4
11 months ago
0.0.3
11 months ago
0.0.2
12 months ago
0.0.1
12 months ago