MasterMath

MasterMath is an intuitive platform designed for math educators to effortlessly create, customize, and assign timed exercises, quizzes, and problem sets.

Customer-Specified Requirements

The application must meet the following minimum requirements:

• Operating System Compatibility: The application shall be compatible with Windows 7 and Linux 64-bit.
• Download Size Optimization: The application’s installation package shall be optimized for minimal size. The target download size shall be less than 5 MiB to ensure accessibility for users with limited bandwidth.
• Russian language.

Building MasterMath on Windows

Prerequisites

• CMake: Install CMake from https://cmake.org/download/. Make sure CMake is added to your system's PATH environment variable.
• Visual Studio build tools: Install Visual Studio build tools with the "Desktop development with C++" workload selected. Ensure the latest Windows SDK is installed.
• Git: Install Git from https://git-scm.com/downloads.

1. vcpkg Installation

vcpkg is used for managing the project's dependencies.

1. Clone the vcpkg repository:

   git clone --depth 1 https://github.com/microsoft/vcpkg
   cd vcpkg

2. Bootstrap vcpkg:

   .\bootstrap-vcpkg.bat

3. Integrate vcpkg with your user environment:

   .\vcpkg integrate install

2. Install Dependencies

Use vcpkg to install the required Boost libraries:

vcpkg install boost-json:x64-windows-static boost-nowide:x64-windows-static 
vcpkg install muparser:x64-windows-static

For tests (optional)

vcpkg install boost-test:x64-windows-static

3. Install nodejs

4. CMake Configuration and Building Create a build directory (if you haven’t already):

mkdir build
cd build

Configure the project with CMake, specifying the vcpkg toolchain file:

cmake -DCMAKE_TOOLCHAIN_FILE=<path_to_vcpkg>\scripts\buildsystems\vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows-static -DCMAKE_BUILD_TYPE=Release ..

bash Replace <path_to_vcpkg> with the actual path to your vcpkg installation directory. For example: C:\dev\vcpkg You can also use -DCMAKE_BUILD_TYPE=Debug for debug builds. Build the project:

cmake --build . --config Release

Building MasterMath on POSIX

Linux Debian 12 (bookworm)

sudo apt install libboost-json1.81-dev libboost-nowide1.81-dev libmuparser-dev
sudo apt install nodejs npm
sudo apt install libboost-test1.81-dev # (optional: for testing)

Linux Debian 13 (trixie)

sudo apt install libboost-json-dev libboost-nowide-dev libmuparser-dev
sudo apt install nodejs npm
sudo apt install libboost-test-dev # (optional: for testing)

Arch Linux

sudo pacman -S muparser boost
sudo pacman -S nodejs npm

Building the Frontend

The project includes a frontend component that requires specific build steps. These are defined as CMake targets.

Install Frontend Dependencies:

cmake --build . --target install-frontend-deps

This target typically handles tasks such as installing Node.js dependencies for the frontend.

Build the Frontend:

cmake --build . --target build-frontend

Running the Application

After successful builds, you can find the executable files in the build directory, typically under build/Release or build/Debug. Refer to the project’s documentation for specific instructions on running the application. The built frontend assets will likely be in a separate frontend specific directory which is also defined in the project’s documentation.