wagesj45/advanced-calculator
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
advanced-calculator/README.md

2.7 KiB
Raw Permalink Blame History

Advanced Calculator

A simple, fast, free‑form calculator. You can type full math expressions, define variables, and see results right away. It runs on desktop, the web (WebAssembly), and Android. The math engine is powered by CS‑MIC.

Screenshot of Advanced Calculator

Features

  • Easy input: Type expressions like 2 + 2 * 3 and press Enter.
  • Variables: Save values and reuse them in later expressions.
  • Linked expressions: Define variables that compute from other variables.
  • History: See past inputs and results; copy any item with a click.
  • Function browser: Browse built‑in functions and insert them quickly.
  • Cross‑platform: Desktop (Windows, macOS, Linux), Web, and Android.

Quick Start

Prerequisite: Install the .NET 8 SDK.

  • Desktop: dotnet run --project src/AdvancedCalculator.Desktop
  • Web (WASM): dotnet run --project src/AdvancedCalculator.Browser then open the URL shown in the console.
  • Android: Build with dotnet build src/AdvancedCalculator.Android -c Debug. Install the APK from the bin folder using Android Studio or adb.

How To Use

  • Evaluate: Type an expression and press Enter, or click the Evaluate button.
  • Define variables:
    • Set a value: x :: 5
    • Link to an expression: y := x * 2 The Variables panel shows both the stored value and, for linked ones, the current computed result.
  • Insert helpers: Use the Variables panel or the Functions button to insert names into the input box.
  • Copy: Right‑click a history item to copy the input, output, or both.

For all supported operators and functions, see the CS‑MIC usage guide: http://cs-mic.com/usage/

Build and Publish

You can create self‑contained builds for desktop platforms.

  • Windows (x64):
    • dotnet publish src/AdvancedCalculator.Desktop -c Release -r win-x64 --self-contained true
  • Linux (x64):
    • dotnet publish src/AdvancedCalculator.Desktop -c Release -r linux-x64 --self-contained true
  • macOS (Intel or Apple Silicon):
    • dotnet publish src/AdvancedCalculator.Desktop -c Release -r osx-x64 --self-contained true
    • dotnet publish src/AdvancedCalculator.Desktop -c Release -r osx-arm64 --self-contained true

Web build output is written to the out folder when running the Browser project.

Technology

Privacy

This app does not send your data anywhere. All calculations run on your device.

Contributing

Issues and pull requests are welcome. If you want to add features or fix bugs, please open an issue to discuss first.

License

MIT License. See the LICENSE file for details.