mark-wiemer / math-with-mark

Free, accessible, interactive math lessons. (Under construction)

Math with Mark

Math with Mark is a website designed to assist math tutors and students. It provides tools and tips for learners to better understand how to approach and solve math problems. Ideally, Math with Mark helps students develop logical reasoning skills that they can apply in their day-to-day life.

Of course, the site doesn't exist yet. But I'm working on it! Check back often.

Toolchain

• React
• React Bootstrap

math-with-mark's Issues

Steps not showing

check out good tag where it works and then fixup-katex branch where it doesn't

problem is new parser not including the ParenthesisNodes that we explicitly want

We'll have to do something about that...

Fix large bundle

npm run build shouldn't give any warnings

File sizes after gzip:

555.87 kB build\static\js\main.447de059.js
1.79 kB build\static\js\787.72a0094a.chunk.js

The bundle size is significantly larger than recommended.
Consider reducing it with code splitting: https://goo.gl/9VhYWB
You can also analyze the project dependencies: https://goo.gl/LeUzfb

Deploy optimized production build

Wait for bugfix: fast-reflexes/better-react-mathjax#42

Run tests on PRs

Improve e2e dev experience

Currently devs on Windows machines have to manually copy changed files and run a janky PowerShell script. Fully automate process to copy win32 files as linux files always with resilient script.

Support fraction arithmetic

    // rules.test.ts

    const sut = ruleSut(rules.RuleID.Arithmetic);

    it('combines fractions of the same denominator', () => {
      expect(sut('1 / 3 + 1 / 3')).toEqual('2 / 3');
      expect(sut('1 / 3 * 2 / 3')).toEqual('2 / 9');
    });

    it('simplifies fractions', () => {
      expect(sut('4 / 6')).toEqual('2 / 3');
      expect(sut('8 / 2')).toEqual('4');
    });

    it('combines fractions of different denominators', () => {
      expect(sut('1 / 2 + 1 / 4')).toEqual('3 / 4');
      expect(sut('1 / 2 * 1 / 4')).toEqual('1 / 8');
    });

    it('combines and simplifies fractions', () => {
      expect(sut('1 / 4 + 1 / 4')).toEqual('1 / 2');
      expect(sut('3 / 4 * 1 / 3')).toEqual('1 / 4');
    });

Transfer to math-with-mark org to enable merge queue

• remove ownership of this domain
• verify as math-with-mark
• transfer
• update settings

there will be downtime, such is life

Improve test performance

Use Vite instead of react-scripts

react-scripts is a big old unmaintained black box. Build with Vite instead.

Research value of following ESM format

Auto-deploy on merge to main

Enforce good file formatting

e2e tests

iinkJS

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

Acceptance criteria

• What must be done in order for this feature to be completed
• A bulleted list is the preferred format

site is down

containerize

Resolve potential issues with e2e screenshots as well as be super cool

KaTeX div child of p warning

Format fractions

TeX: raw input
Math: MathJS string representation
Node: MathJS object representation

TeX: \frac{1}{2}
Math: 1 \frac 2
Node: ✅

However, when rendering in KaTeX we're still seeing 1 \frac 2 instead of the actual fraction

Site isn't secure

Renew the cert!

add issues to project

easier to sort that way

Fixup open-source parser

texToNode('\left(x\right)') should make a parenthesis node, not a symbol node

Render eval steps in KaTeX

Main is built unnecessarily