Skip to content
Projects

Labkeeper-team/LabkeeperEditor has 35 GitHub stars and 3 forks. Star changes are not measured yet. Last checked 2026-11-16 00:00 UTC. Last push 2026-11-14.

How these counts are measured

Measured star growth

in 24h
Update delayed
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Labkeeper online LaTeX editor ReactTs frontend

Web & Apps

README.md

Original
Labkeeper

Labkeeper

Online LaTeX editor with a built-in scientific calculator and LLM-agent

Write and compile LaTeX in the browser, mix in calculations and plots, and export the result to PDF.

labkeeper.io

React TypeScript Vite Node.js

Redux React Router Sass CodeMirror

Jest Playwright ESLint Prettier

Docker Sentry ECharts MathJax

About

This repository is the Labkeeper web frontend: an online LaTeX editor with a scientific calculator and AI agent.

The core workflow is writing LaTeX (full TeX Live compilation on the backend). You can also drop in computational blocks, formulas, tables, and plots, then compile the document to PDF. Typical building blocks:

  • LaTeX as the primary authoring mode, with full document compilation
  • Markdown segments when you need lighter markup alongside LaTeX
  • Computational segments for assignments, formulas, and error propagation
  • Plots (line, scatter, histogram) via Apache ECharts
  • AsciiMath for a lighter math notation
  • File manager, AI hunk review, OAuth2, token billing, and PDF export

The UI talks to the Labkeeper backend over /api. For local work against the release backend, an Nginx container proxies that path while Vite serves the app.

Tech stack

Area Tools
Runtime Node.js 22 (see .nvmrc)
UI React 19, TypeScript 6, Vite 8, Sass
State & routing Redux Toolkit, React Redux, Redux Persist, React Router 7
Editor CodeMirror 6 (incl. LaTeX language support)
Math & docs MathJax, AsciiMath, react-markdown, PDF.js, jsPDF
Charts Apache ECharts
HTTP & quality Axios, Sentry, ESLint, Prettier, Husky, lint-staged
Tests Jest + Testing Library, Playwright
Local proxy Docker Compose, Nginx

Prerequisites

  • Node.js 22.13+ (matches .nvmrc)
  • npm
  • Docker (needed to talk to the release backend via Nginx)

Local development (frontend + release backend)

  1. Install dependencies from the repo root:

    npm i
    
  2. Start the Nginx reverse proxy (API → backend stand, app → Vite). It also injects the public Yandex SmartCaptcha site key into index.html. The stand is labkeeper.io by default, or e.g. preprod.labkeeper.io:

    docker compose -f scripts/local/nginx/docker-compose.yml up
    
  3. Start the Vite dev server from the repo root:

    npm run dev
    
  4. Open http://localhost. The app from this repo is served on port 80 through Nginx and can talk to the release server.

Scripts

Command Description
npm run dev Vite dev server (--host, port 3000)
npm run build Production build
npm run test:math Unit tests (Jest)
npm run test:ui E2E tests (Playwright)
npm run test:ui:silent Playwright with the line reporter
npx playwright test --ui Playwright UI mode
npm run check ESLint + Prettier check
npm run reformat Prettier auto-format

Testing and lint

# Unit tests
npm run test:math

# E2E (retries help with flaky UI)
npx playwright test --retries=3

# E2E with the Playwright inspector
npx playwright test --ui

# Lint and format check
npm run check

# Auto-format
npm run reformat