# WebTerm - Full Documentation

> Learn Linux terminal and Git commands interactively in your browser

## About

WebTerm is a free, open-source, browser-based platform for learning Linux terminal commands and Git operations through hands-on interactive tutorials. Users can practice real commands in a safe simulated terminal environment — no installation, no signup, no risk to their actual system. Available in English, Japanese, French, German, Spanish, Portuguese, Dutch, and Arabic.

- Website: https://webterm.app
- English: https://webterm.app/en
- Japanese: https://webterm.app/ja
- French: https://webterm.app/fr
- German: https://webterm.app/de
- Spanish: https://webterm.app/es
- Portuguese: https://webterm.app/pt
- Dutch: https://webterm.app/nl
- Arabic: https://webterm.app/ar

## Tutorial Details

### 1. Getting Started - Terminal Input & Navigation

URL: https://webterm.app/en/tutorials/terminal-basics
Difficulty: Beginner | Missions: 7 | Estimated time: ~14 minutes

Covers:
- Basic terminal input methods
- Cursor navigation with arrow keys
- Cursor navigation with Emacs shortcuts (Ctrl+A, Ctrl+E, Ctrl+F, Ctrl+B)
- Command history navigation with arrow keys
- Command history navigation with Emacs shortcuts (Ctrl+P, Ctrl+N)
- Tab completion for commands and file names
- Clearing the terminal screen (Ctrl+L, clear)

### 2. Beginner - File Navigation

URL: https://webterm.app/en/tutorials/beginner
Difficulty: Beginner | Missions: 9 | Estimated time: ~18 minutes

Commands taught: pwd, ls, cd, mkdir, touch, rm

Missions:
1. Check current directory with pwd
2. List directory contents with ls
3. Navigate to a directory with cd
4. Go to parent directory with cd ..
5. Navigate to home with cd ~
6. Create a directory with mkdir
7. Navigate into the created directory
8. Create a file with touch
9. Delete a file with rm

### 3. Fundamentals - File Operations

URL: https://webterm.app/en/tutorials/basic
Difficulty: Intermediate | Missions: 14 | Estimated time: ~28 minutes

Commands taught: cat, ls -l, ls -a, cp, mv, mkdir -p, echo, grep, find

Missions:
1. Display file contents with cat
2. List detailed file information with ls -l
3. Show hidden files with ls -a
4. Combine options with ls -la
5. Copy a file with cp
6. Copy a directory recursively with cp -r
7. Move/rename a file with mv
8. Create nested directories with mkdir -p
9. Write to a file with echo >
10. View file before appending
11. Append to a file with echo >>
12. View file after appending
13. Search text with grep
14. Find files with find

### 4. Advanced - Power Commands

URL: https://webterm.app/en/tutorials/advanced
Difficulty: Advanced | Missions: 9 | Estimated time: ~18 minutes

Commands taught: head, tail, less, wc, sort, tree, chmod, stat

Missions:
1. View first lines of a file with head
2. View last lines of a file with tail
3. Browse file content with less
4. Count lines/words with wc
5. Sort file content with sort
6. Display directory tree with tree
7. View file permissions with ls -l
8. Change file permissions with chmod
9. View detailed file info with stat

### 5. What is Git? - Conceptual Introduction

URL: https://webterm.app/en/tutorials/git-what
Difficulty: Beginner | Missions: 6 | Estimated time: ~12 minutes

Covers:
1. What is Git?
2. Why do we need Git?
3. What can Git do?
4. Core Git concepts (repository, commit, branch)
5. The Git workflow
6. Summary

### 6. Git Basics - First Repository

URL: https://webterm.app/en/tutorials/git-intro
Difficulty: Beginner | Missions: 9 | Estimated time: ~18 minutes

Commands taught: git init, git status, git add, git commit, git log

Missions:
1. Initialize a Git repository with git init
2. Check Git status with git status
3. Create a file with touch
4. See untracked files in git status
5. Stage a file with git add
6. Verify staging with git status
7. Create a commit with git commit
8. Check post-commit status
9. View commit history with git log

### 7. Git Fundamentals - Branching & History

URL: https://webterm.app/en/tutorials/git-basic
Difficulty: Intermediate | Missions: 19 | Estimated time: ~38 minutes

Commands taught: git init, git add, git commit, git branch, git checkout, git diff, git log --oneline, git show, git reset, git restore

Missions:
1. Initialize a Git repository
2. Create a file
3. Stage the file
4. Create first commit
5. View branches with git branch
6. Create and switch branch with git checkout -b
7. Make changes (append to file)
8. View changes with git diff
9. Stage changes
10. Create second commit
11. View compact history with git log --oneline
12. View commit details with git show
13. Make more changes
14. Stage changes
15. Check staging status
16. Unstage with git reset
17. Verify unstaged status
18. Discard changes with git restore
19. Verify clean working tree

### Free Play - Sandbox Mode

URL: https://webterm.app/en/free-play
Difficulty: Any | No guided missions

A free-form sandbox where users can practice any Linux terminal commands and Git operations without guided tutorials. Supports the same 30+ commands available in tutorials. Ideal for experimentation and self-directed practice.

## Frequently Asked Questions

### What is WebTerm?
WebTerm is a free, browser-based interactive learning platform for Linux terminal commands and Git. It provides a simulated terminal environment where users can safely practice real commands without any risk to their actual system.

### Do I need to install anything?
No. WebTerm runs entirely in your browser. There is no software to download, no virtual machine to set up, and no account to create.

### Is WebTerm free?
Yes, WebTerm is completely free and open-source. No payment or account registration is required.

### What commands does WebTerm support?
WebTerm supports 30+ Linux commands including: ls, cd, pwd, mkdir, touch, rm, cp, mv, cat, head, tail, less, echo, grep, find, wc, sort, tree, chmod, stat, and more. It also simulates Git operations including git init, git add, git commit, git log, git branch, git checkout, git diff, git reset, and git restore.

### What languages is WebTerm available in?
WebTerm is available in English, Japanese, French, German, Spanish, Portuguese, Dutch, and Arabic.

### Can WebTerm harm my computer?
No. WebTerm uses a virtual file system that runs entirely in the browser. No commands affect your actual operating system or files.

## Technical Details

- Built with Next.js (App Router)
- Virtual file system runs entirely in the browser
- Simulated terminal supports 30+ Linux commands
- Git simulation includes repository, staging, commits, branches
- Internationalized with next-intl (English, Japanese, French, German, Spanish, Portuguese, Dutch, and Arabic)
- No backend required — all computation is client-side