{"id":13627852,"url":"https://github.com/yonatanmgr/mathberet","last_synced_at":"2025-04-17T00:32:39.089Z","repository":{"id":118704141,"uuid":"607820050","full_name":"yonatanmgr/mathberet","owner":"yonatanmgr","description":"Mathberet is a self-hosted digital mathematics notebook written in React and Typescript, designed for math students who need a platform for graphing, sketching, and writing in LaTeX.","archived":false,"fork":false,"pushed_at":"2023-05-24T23:47:54.000Z","size":21248,"stargazers_count":177,"open_issues_count":11,"forks_count":12,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-08T18:45:30.547Z","etag":null,"topics":["javascript","math","mathematics","notebook","notes","react","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yonatanmgr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-02-28T18:38:04.000Z","updated_at":"2024-08-17T07:35:58.000Z","dependencies_parsed_at":"2023-06-03T06:30:22.673Z","dependency_job_id":null,"html_url":"https://github.com/yonatanmgr/mathberet","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonatanmgr%2Fmathberet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonatanmgr%2Fmathberet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonatanmgr%2Fmathberet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonatanmgr%2Fmathberet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yonatanmgr","download_url":"https://codeload.github.com/yonatanmgr/mathberet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249293086,"owners_count":21245679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","math","mathematics","notebook","notes","react","typescript"],"created_at":"2024-08-01T22:00:39.335Z","updated_at":"2025-04-17T00:32:38.193Z","avatar_url":"https://github.com/yonatanmgr.png","language":"TypeScript","readme":"\n\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/yonatanmgr/mathberet/assets/31913495/380ecf5e-5449-4646-ab4d-ac305bc96286\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/yonatanmgr/mathberet/assets/31913495/557554da-7617-4b1b-b34b-79d4e34b4c78\"\u003e\n    \u003cimg width=500 src=\"https://github.com/yonatanmgr/mathberet/assets/31913495/380ecf5e-5449-4646-ab4d-ac305bc96286\" alt=\"mathberet logo\"\u003e\n  \u003c/picture\u003e\n  \u003cp\u003e\u003cb\u003e📝 Mathberet (Hebrew: מַתְבֶּרֶת)\u003c/b\u003e - A self-hosted digital mathematics notebook, written in React and built with Electron\u003c/p\u003e\n  \u003cp\u003e\u003cb\u003e🚧 In active development, open for contributions! 🚧\u003c/b\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n\u003e Currently works in Hebrew, English, Arabic, Russian and Spanish, localized using [i18next](https://github.com/i18next/i18next). Still buggy.\n\n## :white_check_mark: Features\n\n- [x] Block based drag-n-drop editor\n- [x] Text, Math, Graph and Drawing blocks are currently available\n- [x] LaTeX shortcuts and snippets\n- [x] Local files can be saved and loaded from the file system\n- [x] File tags (currently useless)\n- [x] Command bar (currently only used for user preferences)\n- [x] 6 color themes and light/dark theme\n- [ ] Customize LaTeX shortcuts\n- [ ] Shortcuts help menu\n- [ ] Searching from command bar\n- [ ] Adding points and polygons to graph blocks\n- [ ] Math memory sidebar (for variable assignments and quick functions)\n- [ ] Archive\n\n## :camera_flash: Screenshots\n\n### Hebrew\n\n![image](https://user-images.githubusercontent.com/31913495/225077627-82fa032c-88e7-4e25-971f-98a37a436d40.jpg)\n\u003c/details\u003e\n\n### English\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eDark theme and purple accent color\u003c/b\u003e\u003c/summary\u003e\n\n![image](https://user-images.githubusercontent.com/31913495/225168731-13afd8f2-7e17-448d-a434-5b6bd1f43494.png)\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eLight theme and green accent color\u003c/b\u003e\u003c/summary\u003e\n\n![image](https://user-images.githubusercontent.com/31913495/225170025-65b7cde0-434d-4c66-8d9a-1c9237a92f3b.png)\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eCommand bar (\u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e)\u003c/b\u003e\u003c/summary\u003e\n\n![image](https://user-images.githubusercontent.com/31913495/225170120-e3dcdeb3-bdf2-4fa9-80dc-f2ebbfe2051b.png)\n\u003c/details\u003e\n\n## :bricks: Built With\n\n- [ERWT](https://github.com/codesbiome/electron-react-webpack-typescript-2023): Electron + React apps boilerplate\n- [react-grid-layout](https://github.com/react-grid-layout/react-grid-layout): Grid layout for the blocks\n- [slate](https://github.com/ianstormtaylor/slate): Text block component\n- [MathLive](https://cortexjs.io/mathlive/) ([react-math-view](https://github.com/arnog/react-mathlive)): Math block component\n- [Mafs](https://mafs.dev/): Graph block component\n- [tldraw](https://github.com/tldraw/tldraw): Drawing block component\n- [kbar](https://kbar.vercel.app/): Command bar\n- [react-complex-tree](https://rct.lukasbach.com/): Used for displaying the file system\n- [UIcons](https://github.com/freepik-company/flaticon-uicons): App icons\n\n## :building_construction: Building from source\n\n1. Clone the repository to a folder on your machine:\n```bash\ngit clone https://github.com/yonatanmgr/mathberet.git\n```\n2. Run `npm install` in the project root folder\n3. Run `npm start` in the project root folder\n\n## :handshake: Contributing\n\nWe welcome any positive contribution towards our project's growth! Whether you choose to work on a [listed feature](https://github.com/yonatanmgr/mathberet#white_check_mark-features) or create a new one, your help is appreciated. Simply submit a Pull Request after adding your code. To ensure a smooth process, please review our `CODE OF CONDUCT` and read the `CONTRIBUTING` guidelines for further details on submitting pull requests.\n\nMake sure to visit Mathberet's [project](https://github.com/users/yonatanmgr/projects/2) to view our roadmap and plans, and our [wiki](https://github.com/yonatanmgr/mathberet/wiki/%F0%9F%8F%A0-Home) to read the documentation!\n\n## :balance_scale: Liscense\n\nThis project is licensed under the MIT License - see the `LICENSE` file for details.\n\n## :technologist: Contributors\n\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/yonatanmgr\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/31913495?v=3?s=100\" width=\"100px;\" alt=\"Yonatan Magier\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eYonatan Magier\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\n        \u003cspan title=\"Ideas \u0026 Planning\"\u003e🤔\u003c/span\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=yonatanmgr\" title=\"Code\"\u003e💻\u003c/a\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=yonatanmgr\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/tree/master/src/common/locals\" title=\"Translation\"\u003e🌍\u003c/a\u003e\n        \u003cspan title=\"Design\"\u003e🎨\u003c/span\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/ErezBiren\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/7828909?v=3?s=100\" width=\"100px;\" alt=\"Erez Birenholz\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eErez Birenholz\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\n        \u003cspan title=\"Mentoring\"\u003e🧑‍🏫\u003c/span\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=ErezBiren\" title=\"Code\"\u003e💻\u003c/a\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=ErezBiren\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/tree/master/src/common/locals\" title=\"Translation\"\u003e🌍\u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Nadav0077\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/18245584?v=3?s=100\" width=\"100px;\" alt=\"Nadav Magier\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eNadav Magier\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=Nadav0077\" title=\"Code\"\u003e💻\u003c/a\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=Nadav0077\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/tree/master/src/common/locals\" title=\"Translation\"\u003e🌍\u003c/a\u003e\n        \u003cspan title=\"Security\"\u003e🛡️\u003c/span\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/zivnadel\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/52624380?v=3?s=100\" width=\"100px;\" alt=\"Ziv Nadel\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eZiv Nadel\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=zivnadel\" title=\"Code\"\u003e💻\u003c/a\u003e\n        \u003ca href=\"https://github.com/yonatanmgr/mathberet/commits?author=zivnadel\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n","funding_links":[],"categories":["Projects by main language"],"sub_categories":["typescript"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyonatanmgr%2Fmathberet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyonatanmgr%2Fmathberet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyonatanmgr%2Fmathberet/lists"}