feat: Add comprehensive internationalization (i18n) support with English and Chinese languages

README.md

@@ -3,6 +3,7 @@
   <h1>Claude Code UI</h1>
 </div>
 
+[中文文档 README.zh-CN](./README.zh-CN.md)
 
 A desktop and mobile UI for [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and [Cursor CLI](https://docs.cursor.com/en/cli/overview). You can use it locally or remotely to view your active projects and sessions in Claude Code or Cursor and make changes to them from everywhere (mobile or desktop). This gives you a proper interface that works everywhere. Supports models including **Claude Sonnet 4**, **Opus 4.1**, and **GPT-5**
 
@@ -35,22 +36,19 @@ A desktop and mobile UI for [Claude Code](https://docs.anthropic.com/en/docs/cla
 </tr>
 </table>
 
-
-
 </div>
 
 ## Features
 
-- **Responsive Design** - Works seamlessly across desktop, tablet, and mobile so you can also use Claude Code from mobile 
+- **Responsive Design** - Works seamlessly across desktop, tablet, and mobile so you can also use Claude Code from mobile
 - **Interactive Chat Interface** - Built-in chat interface for seamless communication with Claude Code or Cursor
 - **Integrated Shell Terminal** - Direct access to Claude Code or Cursor CLI through built-in shell functionality
 - **File Explorer** - Interactive file tree with syntax highlighting and live editing
-- **Git Explorer** - View, stage and commit your changes. You can also switch branches 
+- **Git Explorer** - View, stage and commit your changes. You can also switch branches
 - **Session Management** - Resume conversations, manage multiple sessions, and track history
-- **TaskMaster AI Integration** *(Optional)* - Advanced project management with AI-powered task planning, PRD parsing, and workflow automation
+- **TaskMaster AI Integration** _(Optional)_ - Advanced project management with AI-powered task planning, PRD parsing, and workflow automation
 - **Model Compatibility** - Works with Claude Sonnet 4, Opus 4.1, and GPT-5
 
-
 ## Quick Start
 
 ### Prerequisites
@@ -70,6 +68,7 @@ npx @siteboon/claude-code-ui
 The server will start and be accessible at `http://localhost:3001` (or your configured PORT).
 
 **To restart**: Simply run the same `npx` command again after stopping the server
+
 ### Global Installation (For Regular Use)
 
 For frequent use, install globally once:
@@ -84,7 +83,6 @@ Then start with a simple command:
 claude-code-ui
 ```
 
-
 **To restart**: Stop with Ctrl+C and run `claude-code-ui` again.
 
 ### CLI Commands
@@ -107,13 +105,14 @@ cloudcli version
 ```
 
 **The `cloudcli status` command shows you:**
+
 - Installation directory location
 - Database location (where credentials are stored)
 - Current configuration (PORT, DATABASE_PATH, etc.)
 - Claude projects folder location
 - Configuration file location
 
-```
+````
 
 ### Run as Background Service (Recommended for Production)
 
@@ -123,7 +122,7 @@ For production use, run Claude Code UI as a background service using PM2 (Proces
 
 ```bash
 npm install -g pm2
-```
+````
 
 #### Start as Background Service
 
@@ -135,7 +134,6 @@ pm2 start claude-code-ui --name "claude-code-ui"
 pm2 start cloudcli --name "claude-code-ui"
 ```
 
-
 #### Auto-Start on System Boot
 
 To make Claude Code UI start automatically when your system boots:
@@ -148,32 +146,36 @@ pm2 startup
 pm2 save
 ```
 
-
 ### Local Development Installation
 
 1. **Clone the repository:**
+
 ```bash
 git clone https://github.com/siteboon/claudecodeui.git
 cd claudecodeui
 ```
 
 2. **Install dependencies:**
+
 ```bash
 npm install
 ```
 
 3. **Configure environment:**
+
 ```bash
 cp .env.example .env
 # Edit .env with your preferred settings
 ```
 
 4. **Start the application:**
+
 ```bash
 # Development mode (with hot reload)
 npm run dev
 
 ```
+
 The application will start at the port you specified in your .env
 
 5. **Open your browser:**
@@ -188,70 +190,76 @@ The application will start at the port you specified in your .env
 To use Claude Code's full functionality, you'll need to manually enable tools:
 
 1. **Open Tools Settings** - Click the gear icon in the sidebar
-3. **Enable Selectively** - Turn on only the tools you need
-4. **Apply Settings** - Your preferences are saved locally
+2. **Enable Selectively** - Turn on only the tools you need
+3. **Apply Settings** - Your preferences are saved locally
 
 <div align="center">
 
 ![Tools Settings Modal](public/screenshots/tools-modal.png)
-*Tools Settings interface - enable only what you need*
+_Tools Settings interface - enable only what you need_
 
 </div>
 
 **Recommended approach**: Start with basic tools enabled and add more as needed. You can always adjust these settings later.
 
-## TaskMaster AI Integration *(Optional)*
+## TaskMaster AI Integration _(Optional)_
 
 Claude Code UI supports **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** (aka claude-task-master) integration for advanced project management and AI-powered task planning.
 
 It provides
+
 - AI-powered task generation from PRDs (Product Requirements Documents)
-- Smart task breakdown and dependency management  
+- Smart task breakdown and dependency management
 - Visual task boards and progress tracking
 
 **Setup & Documentation**: Visit the [TaskMaster AI GitHub repository](https://github.com/eyaltoledano/claude-task-master) for installation instructions, configuration guides, and usage examples.
 After installing it you should be able to enable it from the Settings
 
-
 ## Usage Guide
 
 ### Core Features
 
 #### Project Management
+
 The UI automatically discovers Claude Code projects from `~/.claude/projects/` and provides:
+
 - **Visual Project Browser** - All available projects with metadata and session counts
 - **Project Actions** - Rename, delete, and organize projects
 - **Smart Navigation** - Quick access to recent projects and sessions
-- **MCP support** - Add your own MCP servers through the UI 
+- **MCP support** - Add your own MCP servers through the UI
 
 #### Chat Interface
-- **Use responsive chat or Claude Code/Cursor CLI** - You can either use the adapted chat interface or use the shell button to connect to your selected CLI. 
+
+- **Use responsive chat or Claude Code/Cursor CLI** - You can either use the adapted chat interface or use the shell button to connect to your selected CLI.
 - **Real-time Communication** - Stream responses from Claude with WebSocket connection
 - **Session Management** - Resume previous conversations or start fresh sessions
 - **Message History** - Complete conversation history with timestamps and metadata
 - **Multi-format Support** - Text, code blocks, and file references
 
 #### File Explorer & Editor
+
 - **Interactive File Tree** - Browse project structure with expand/collapse navigation
 - **Live File Editing** - Read, modify, and save files directly in the interface
 - **Syntax Highlighting** - Support for multiple programming languages
 - **File Operations** - Create, rename, delete files and directories
 
 #### Git Explorer
 
+#### TaskMaster AI Integration _(Optional)_
 
-#### TaskMaster AI Integration *(Optional)*
 - **Visual Task Board** - Kanban-style interface for managing development tasks
 - **PRD Parser** - Create Product Requirements Documents and parse them into structured tasks
 - **Progress Tracking** - Real-time status updates and completion tracking
 
 #### Session Management
+
 - **Session Persistence** - All conversations automatically saved
 - **Session Organization** - Group sessions by project and timestamp
 - **Session Actions** - Rename, delete, and export conversation history
 - **Cross-device Sync** - Access sessions from any device
 
 ### Mobile App
+
 - **Responsive Design** - Optimized for all screen sizes
 - **Touch-friendly Interface** - Swipe gestures and touch navigation
 - **Mobile Navigation** - Bottom tab bar for easy thumb navigation
@@ -270,31 +278,31 @@ The UI automatically discovers Claude Code projects from `~/.claude/projects/` a
 ```
 
 ### Backend (Node.js + Express)
+
 - **Express Server** - RESTful API with static file serving
 - **WebSocket Server** - Communication for chats and project refresh
 - **CLI Integration (Claude Code / Cursor)** - Process spawning and management
 - **Session Management** - JSONL parsing and conversation persistence
 - **File System API** - Exposing file browser for projects
 
 ### Frontend (React + Vite)
+
 - **React 18** - Modern component architecture with hooks
 - **CodeMirror** - Advanced code editor with syntax highlighting
 
-
-
-
-
 ### Contributing
 
 We welcome contributions! Please follow these guidelines:
 
 #### Getting Started
+
 1. **Fork** the repository
 2. **Clone** your fork: `git clone <your-fork-url>`
 3. **Install** dependencies: `npm install`
 4. **Create** a feature branch: `git checkout -b feature/amazing-feature`
 
 #### Development Process
+
 1. **Make your changes** following the existing code style
 2. **Test thoroughly** - ensure all features work correctly
 3. **Run quality checks**: `npm run lint && npm run format`
@@ -306,6 +314,7 @@ We welcome contributions! Please follow these guidelines:
    - Test results if applicable
 
 #### What to Contribute
+
 - **Bug fixes** - Help us improve stability
 - **New features** - Enhance functionality (discuss in issues first)
 - **Documentation** - Improve guides and API docs
@@ -316,23 +325,25 @@ We welcome contributions! Please follow these guidelines:
 
 ### Common Issues & Solutions
 
-
 #### "No Claude projects found"
+
 **Problem**: The UI shows no projects or empty project list
 **Solutions**:
+
 - Ensure [Claude CLI](https://docs.anthropic.com/en/docs/claude-code) is properly installed
 - Run `claude` command in at least one project directory to initialize
 - Verify `~/.claude/projects/` directory exists and has proper permissions
 
 #### File Explorer Issues
+
 **Problem**: Files not loading, permission errors, empty directories
 **Solutions**:
+
 - Check project directory permissions (`ls -la` in terminal)
 - Verify the project path exists and is accessible
 - Review server console logs for detailed error messages
 - Ensure you're not trying to access system directories outside project scope
 
-
 ## License
 
 GNU General Public License v3.0 - see [LICENSE](LICENSE) file for details.
@@ -342,22 +353,26 @@ This project is open source and free to use, modify, and distribute under the GP
 ## Acknowledgments
 
 ### Built With
+
 - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic's official CLI
 - **[React](https://react.dev/)** - User interface library
 - **[Vite](https://vitejs.dev/)** - Fast build tool and dev server
 - **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first CSS framework
 - **[CodeMirror](https://codemirror.net/)** - Advanced code editor
-- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(Optional)* - AI-powered project management and task planning
+- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** _(Optional)_ - AI-powered project management and task planning
 
 ## Support & Community
 
 ### Stay Updated
+
 - **Star** this repository to show support
 - **Watch** for updates and new releases
 - **Follow** the project for announcements
 
 ### Sponsors
+
 - [Siteboon - AI powered website builder](https://siteboon.ai)
+
 ---
 
 <div align="center">