🌐 Choose your language / 选择语言

🌐 Language	选择语言
English	中文

---

English

Text-based Calculator (with Equation Solver)

A text-based calculator application, a static frontend project.

Allows users to calculate results by entering expressions in a text area, supporting linear equations with one variable.

The project is built using React, TypeScript, Vite, pnpm, Tailwind CSS, and Shadcn UI.

Example

A demo page deployed using Cloudflare Pages -> Cloudflare Demo URL

Features

• Basic Arithmetic: Performs addition, subtraction, multiplication, division, and other standard mathematical operations.
• Equation Solving: Solves linear equations with a single variable 'x'.
• Comment Support: Allows users to add comments to their calculations using the # symbol. The part after # will be treated as a comment and ignored during calculation.
• Responsive Design: Adapts to different screen sizes using a two-column layout.
• Formatted Output: Displays numbers in a user-friendly way. Formats the output, displaying percentages if the value is too small.
• Input Caching: Caches the user's input. Restores the input when the webpage is opened next time.
• PWA Support: After deployment using Https, it can be installed as a local application through PWA.
• Cloud Provider Pages Deployment: Supports static deployment on various service providers' pages.

Tech Stack

• Frontend Framework: React
• Language: TypeScript
• Build Tool: Vite
• Package Manager: pnpm
• Styling: Tailwind CSS
• UI Components: Shadcn UI
• Math Library: Math.js

Quick Start

1. Clone the repository:

   git clone https://github.com/Knowckx/text-calcer.git
   cd text-calcer

2. Install dependencies:

   pnpm install

3. Run the development server:

   pnpm dev

   This will start the development server, usually on http://localhost:3000. Open this URL in your browser to view the application.

4. Local deployment, supporting PWA application installation:

   pnpm run build
   pnpm preview --host

Contributing

Fork/Star are welcome.

If you find any bugs or have suggestions for improvement, please submit an issue or pull request.

License

This project is licensed under the GPL3 License.

---

中文

欢迎阅读项目文档！

基于文本的计算器（带方程求解）

基于文本的计算器应用，一个静态前端项目

允许用户通过在文本区域中输入表达式来求计算结果，支持一元一次方程。

项目使用 React、TypeScript、Vite、pnpm、Tailwind CSS 和 Shadcn UI 构建。

例子

使用Cloudflare Pages部署的一个示例页面 -> Cloudflare Demo URL

功能特性

• 基础算术： 执行加法、减法、乘法、除法和其他标准数学运算。
• 方程求解： 求解具有单个变量 'x' 的线性方程。
• 注释支持： 允许用户使用 # 符号向其计算添加注释。 # 后面的部分将被视为注释，并在计算过程中被忽略。
• 格式化输出： 以用户友好的方式显示数字。格式化输出， 除法值显示百分比。
• 缓存输入内容： 缓存用户输入的内容 下次打开网页时进行复原
• PWA支持： 使用Https部署后可以通过PWA安装到本地应用
• 云服务商pages部署： 支持各种服务商的pages静态部署

技术栈

• 前端框架: React
• 语言: TypeScript
• 构建工具: Vite
• 包管理器: pnpm
• 样式: Tailwind CSS
• UI 组件: Shadcn UI
• 数学库: Math.js

快速开始

1. 克隆仓库:

   git clone https://github.com/Knowckx/text-calcer.git
   cd text-calcer

2. 安装依赖:

   pnpm install

3. 运行开发服务器:

   pnpm dev

   这将启动开发服务器，通常在 http://localhost:3000 上。在浏览器中打开此 URL 以查看应用程序。

4. 本地部署，支持安装PWA应用:

   pnpm run build
   pnpm preview --host

贡献

欢迎Fork / Star

如果您发现任何错误或有改进建议，请提交一个 issue 或 pull request。

许可证

本项目根据 GPL3 许可证 获得许可