add

2025-04-10 18:06:45 +08:00
commit 54650cd944
154 changed files with 29090 additions and 0 deletions
@@ -0,0 +1,147 @@
+[中文文档](README.zh-CN.md)
+
+## JiSuXiang | Developer Toolbox
+
+JiSuXiang (极速箱) is a high-quality, visually appealing online developer toolbox that provides a comprehensive collection of essential development tools for programmers. Built with Next.js and TailwindCSS, this platform offers a wide range of utilities for everyday programming tasks with a beautiful, modern UI design.
+
+**Live Demo**: [https://www.jisuxiang.com/](https://www.jisuxiang.com/) - Try it now!
+
+
+
+
+
+## 🚀 Features
+
+- **Multiple Tool Categories**: JSON processing, encoding/decoding, network testing, and more
+- **Responsive Design**: Optimized for all device sizes
+- **Dark Theme**: Eye-friendly interface for extended coding sessions
+- **Efficient Search**: Quickly find tools with powerful search functionality
+- **Favorites System**: Save frequently used tools for easy access
+- **Multi-language Support**: Available in English and Chinese
+
+## 🔧 Tools Included
+
+- JSON Formatter & Validator
+- HTTP Request Tester
+- Timestamp Converter
+- Encoding/Decoding Tools
+- Regular Expression Tester
+- Cryptographic Tools
+- Color Picker & Converter
+- Code Formatter
+- JSON Editor & Converter
+- IP Address Lookup
+- Date Calculator
+- Timezone Converter
+- Text Statistics
+- HTML/Markdown Converter
+- Image Compression
+- QR Code Generator
+- CSS Gradient Generator
+- And more...
+
+## 🛠️ Tech Stack
+
+- [Next.js](https://nextjs.org) - React framework for production
+- [TailwindCSS](https://tailwindcss.com) - Utility-first CSS framework
+- [Font Awesome](https://fontawesome.com) - Icon library
+- [TypeScript](https://www.typescriptlang.org/) - Type-safe JavaScript
+
+## 📦 Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/jisuxiang.git
+cd jisuxiang
+```
+
+2. Install dependencies:
+```bash
+npm install
+# or
+yarn install
+# or
+pnpm install
+```
+
+3. Run the development server:
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+```
+
+4. Open [http://localhost:3000](http://localhost:3000) in your browser to see the application.
+
+## 🚢 Deployment
+
+### Using Docker
+
+A Dockerfile is provided for containerized deployment:
+
+```bash
+# Build the Docker image
+docker build -t jisuxiang .
+
+# Run the container
+docker run -p 3000:3000 jisuxiang
+```
+
+### Using Node.js
+
+For production deployment on a Node.js server:
+
+```bash
+# Build the application
+npm run build
+
+# Start the production server
+npm start
+```
+
+## 🧩 Project Structure
+
+```
+jisuxiang/
+├── src/
+│   ├── app/              # Next.js app directory (pages, layouts)
+│   ├── components/       # Reusable UI components
+│   ├── config/           # Configuration files
+│   │   ├── categories.ts # Tool category definitions
+│   │   ├── tools.ts      # Tool definitions
+│   │   └── i18n/         # Internationalization files
+│   ├── context/          # React context providers
+│   ├── types/            # TypeScript type definitions
+│   └── utils/            # Utility functions
+├── public/               # Static assets
+└── ...                   # Configuration files
+```
+
+## 🧪 Development
+
+To add a new tool:
+
+1. Create a new directory in `src/app/tools/[tool_code]/`
+2. Add tool to the configuration in `src/config/tools.ts`
+3. Add translations in `src/config/i18n/tools/[tool_code]/`
+
+## 🌍 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- GitHub Repository: [https://github.com/yourusername/jisuxiang](https://github.com/yourusername/jisuxiang)
+