|
1 | 1 | --- |
2 | 2 | title: Terminal |
3 | | -description: Advanced terminal emulation with full command-line integration, multiple sessions, and seamless project environment access. |
| 3 | +description: Type commands to control your project, just like a computer's command line |
4 | 4 | --- |
5 | 5 |
|
6 | | -The Terminal Interface provides a fully-featured command-line environment directly within your development workspace, enabling seamless execution of build commands, package management, and system operations. |
| 6 | +The Terminal is like a text-based remote control for your project. Instead of clicking buttons, you type commands to tell your computer what to do. |
7 | 7 |
|
8 | | -## Overview |
| 8 | +## What is the Terminal? |
9 | 9 |
|
10 | | -Built on XTerm.js, the terminal component offers professional-grade terminal emulation with support for multiple sessions, theming, and interactive command execution. It integrates deeply with your project's environment, providing access to all development tools and scripts. |
| 10 | +Think of the Terminal as a way to talk directly to your computer using text commands. It's like texting your computer to ask it to do things. |
11 | 11 |
|
12 | 12 | <CardGroup cols={3}> |
13 | | - <Card title="Command Execution" icon="terminal"> |
14 | | - Run build scripts, package managers, and development tools |
| 13 | + <Card title="Run Commands" icon="terminal"> |
| 14 | + Tell your computer what to do by typing |
15 | 15 | </Card> |
16 | | - <Card title="Session Management" icon="layers"> |
17 | | - Multiple terminal tabs for different workflows |
| 16 | + <Card title="Multiple Tabs" icon="layers"> |
| 17 | + Open several terminals at once |
18 | 18 | </Card> |
19 | | - <Card title="Theme Integration" icon="palette"> |
20 | | - Consistent theming with your development environment |
| 19 | + <Card title="See Results" icon="palette"> |
| 20 | + Watch what happens when you run commands |
21 | 21 | </Card> |
22 | 22 | </CardGroup> |
23 | 23 |
|
24 | | -## Key Features |
| 24 | +## What Can You Do? |
25 | 25 |
|
26 | | -<AccordionGroup> |
27 | | - <Accordion title="Terminal Emulation" icon="monitor"> |
28 | | - ### Advanced Terminal Capabilities |
| 26 | +### Running Commands |
29 | 27 |
|
30 | | - Professional terminal emulation supporting: |
31 | | - - **Full ANSI escape sequences** - Rich text formatting and colors |
32 | | - - **Mouse support** - Interactive terminal applications |
33 | | - - **Unicode support** - International character display |
34 | | - - **Web links** - Clickable URLs in terminal output |
| 28 | +You can type commands to: |
| 29 | +- Start your app so you can see it working |
| 30 | +- Install new tools and libraries |
| 31 | +- Check if your code has any problems |
| 32 | +- Save your work to GitHub |
35 | 33 |
|
36 | | - </Accordion> |
| 34 | +### Common Commands |
37 | 35 |
|
38 | | - <Accordion title="Environment Integration" icon="cog"> |
39 | | - ### Project Environment Access |
| 36 | +Here are some commands you might use: |
| 37 | +- `npm install` - Download tools your project needs |
| 38 | +- `npm start` - Start your app |
| 39 | +- `npm test` - Check if everything works correctly |
| 40 | +- `git status` - See what files you've changed |
40 | 41 |
|
41 | | - Complete access to your development environment: |
42 | | - - **Project directory** - Automatic navigation to workspace |
43 | | - - **Environment variables** - Access to configured variables |
44 | | - - **Installed tools** - Node.js, npm, git, and other tools |
45 | | - - **File permissions** - Full read/write access to project files |
| 42 | +### Using Multiple Terminals |
46 | 43 |
|
47 | | - </Accordion> |
| 44 | +You can open several terminal tabs at once, like having multiple conversations: |
| 45 | +- One tab runs your app |
| 46 | +- Another tab runs tests |
| 47 | +- A third tab is ready for quick commands |
48 | 48 |
|
49 | | - <Accordion title="Interactive Features" icon="zap"> |
50 | | - ### Enhanced User Experience |
| 49 | +This way, you don't have to stop one thing to do another. |
51 | 50 |
|
52 | | - Modern terminal features for improved productivity: |
53 | | - - **Command history** - Navigate through previous commands |
54 | | - - **Auto-completion** - Intelligent command suggestions |
55 | | - - **Search functionality** - Find text within terminal output |
56 | | - - **Copy/paste support** - Standard clipboard operations |
57 | | - - **Live action console** - Real-time streaming output for running commands |
| 51 | +### Helpful Features |
58 | 52 |
|
59 | | - </Accordion> |
| 53 | +The terminal has some handy tricks: |
| 54 | +- **Command history** - Press the up arrow to see commands you typed before |
| 55 | +- **Copy and paste** - Copy text in and out of the terminal |
| 56 | +- **Search** - Find specific text in the terminal output |
| 57 | +- **Live updates** - See results appear as they happen |
60 | 58 |
|
61 | | - <Accordion title="Live Action Console" icon="activity"> |
62 | | - ### Real-Time Command Monitoring |
63 | | - |
64 | | - Monitor command execution with live streaming output: |
65 | | - - **Real-time output** - See command output as it happens |
66 | | - - **Progress tracking** - Visual progress indicators for long-running tasks |
67 | | - - **Command context** - Know which command is currently executing |
68 | | - - **Streaming display** - Continuous output updates without page refresh |
69 | | - |
70 | | - <Callout type="info"> |
71 | | - **Enable Live Console**: Toggle this feature in Settings → Features to see real-time command output in a floating console. |
72 | | - </Callout> |
73 | | - |
74 | | - </Accordion> |
75 | | -</AccordionGroup> |
76 | | - |
77 | | -## Usage Modes |
78 | | - |
79 | | -<BadgeGroup> |
80 | | - <Badge variant="secondary">Read-Write Mode</Badge> |
81 | | - <Badge variant="secondary">Read-Only Mode</Badge> |
82 | | - <Badge variant="secondary">Background Execution</Badge> |
83 | | -</BadgeGroup> |
84 | | - |
85 | | -### Terminal States |
86 | | - |
87 | | -- **Active Session** - Full command execution and interaction |
88 | | -- **Read-Only** - Output display without input capability |
89 | | -- **Background** - Commands running without visible interface |
| 59 | +<Callout type="info"> |
| 60 | + **Live Console**: Turn on the live console in Settings → Features to see command results in a floating window while you work. |
| 61 | +</Callout> |
90 | 62 |
|
91 | 63 | <Callout type="tip"> |
92 | | - **Pro Tip**: Use multiple terminal tabs to run development servers, build processes, and testing simultaneously |
93 | | - without switching contexts. |
| 64 | + **Quick Tip**: Open multiple terminal tabs to run your app in one tab while typing other commands in another tab. |
94 | 65 | </Callout> |
0 commit comments