Alf Eaton 09c5bf72d2 [cm6] Use Cmd on macOS for cloneSelectionVertically (#12855) 3 tahun lalu
..
.github e3f41ab373 Merge pull request #3342 from overleaf/jpa-hide-dependabot-cfg 6 tahun lalu
.vscode c6f9da69da Merge pull request #10995 from overleaf/lg-update-tpds-dropbox-only 3 tahun lalu
app e89b4b4214 Merge pull request #12811 from overleaf/jk-plans-event-currency-segmentation 3 tahun lalu
bin 663aace586 Merge pull request #11674 from overleaf/jpa-check-extracted-translations-in-ci 3 tahun lalu
config cff54eae78 Merge pull request #12575 from overleaf/em-fix-chunk-replace-transaction 3 tahun lalu
cypress acf6abb0fb [cm6] Use a block widget for padding at the top of the editor (#12705) 3 tahun lalu
data d706109823 Merge pull request #5615 from overleaf/revert-5611-revert-4746-ae-project-history 5 tahun lalu
frontend 09c5bf72d2 [cm6] Use Cmd on macOS for cloneSelectionVertically (#12855) 3 tahun lalu
locales e0d9069131 [cm6] Add "within selection" option to the search form (#12798) 3 tahun lalu
migrations 66d29940c3 Merge pull request #12861 from overleaf/em-ds-delete-chunk-migration 3 tahun lalu
modules 6ef9be0d0c Merge pull request #12858 from overleaf/jpa-server-ce-script-change-compile-timeout 3 tahun lalu
public df58f6720e Merge pull request #12609 from overleaf/jel-request-for-service-pdf 3 tahun lalu
scripts 05f963d17d Merge pull request #12878 from overleaf/em-hash-oauth-secrets-2 3 tahun lalu
test 6c21f0821c [cm6] Handle multiple selection ranges when applying snippets (#12830) 3 tahun lalu
transform 1be43911b4 Merge pull request #3942 from overleaf/prettier-trailing-comma 5 tahun lalu
types 7f37ba737c Move source editor out of module (#12457) 3 tahun lalu
webpack-plugins 7f37ba737c Move source editor out of module (#12457) 3 tahun lalu
.eastrc 11ce07ec50 Merge pull request #1999 from overleaf/spd-migrations 7 tahun lalu
.eslintignore 7f37ba737c Move source editor out of module (#12457) 3 tahun lalu
.eslintrc f375362894 Always use mockable location methods (#11929) 3 tahun lalu
.gitignore 7f37ba737c Move source editor out of module (#12457) 3 tahun lalu
.nvmrc cb8992e912 Merge pull request #12709 from overleaf/bg-rollback-additional-services 3 tahun lalu
.prettierignore 7f37ba737c Move source editor out of module (#12457) 3 tahun lalu
.prettierrc 1be43911b4 Merge pull request #3942 from overleaf/prettier-trailing-comma 5 tahun lalu
Dockerfile cb8992e912 Merge pull request #12709 from overleaf/bg-rollback-additional-services 3 tahun lalu
Dockerfile.frontend cb8992e912 Merge pull request #12709 from overleaf/bg-rollback-additional-services 3 tahun lalu
Dockerfile.frontend.ci 2421593d85 run unit and acceptance tests in parallel (#1545) 7 tahun lalu
Dockerfile.frontend_ct 53324b0cd2 Add Cypress React component testing (#6974) 4 tahun lalu
LICENSE f0f29e2f17 Merge pull request #2976 from overleaf/jpa-import-671 6 tahun lalu
Makefile 46fb6f7c83 Merge pull request #12814 from overleaf/jpa-modules-rs-init 3 tahun lalu
Makefile.module 46fb6f7c83 Merge pull request #12814 from overleaf/jpa-modules-rs-init 3 tahun lalu
README.md c41c14c697 Remove deprecated grunt code (#9506) 4 tahun lalu
app.js 817d1cffaf Only start queue workers/processing in web-api pods (#11800) 3 tahun lalu
babel.config.json edbe12b86f Fix .cjs importing via webpack/babel (#11090) 3 tahun lalu
cypress.config.ts 3a071c247a Merge pull request #12285 from overleaf/jpa-parallel-cypress-tests 3 tahun lalu
docker-compose.ci.yml cff54eae78 Merge pull request #12575 from overleaf/em-fix-chunk-replace-transaction 3 tahun lalu
docker-compose.common.env cb8992e912 Merge pull request #12709 from overleaf/bg-rollback-additional-services 3 tahun lalu
docker-compose.cypress.yml 0b14c55d24 Upgrade Cypress to v12 (#11011) 3 tahun lalu
docker-compose.yml cb8992e912 Merge pull request #12709 from overleaf/bg-rollback-additional-services 3 tahun lalu
i18next-scanner.config.js 55c5973d37 Add custom transform for extracting i18next keys from TypeScript files (#7138) 4 tahun lalu
install_deps.sh f3f0be5c56 Merge pull request #6211 from overleaf/em-code-sharing 4 tahun lalu
karma.conf.js 1be43911b4 Merge pull request #3942 from overleaf/prettier-trailing-comma 5 tahun lalu
local-dev.env fd61e9b2b5 Merge pull request #12554 from overleaf/jdt-dev-google-sso-env-variable 3 tahun lalu
local-test.env 6f4975b721 Merge pull request #9750 from overleaf/ho-redis-volatile 4 tahun lalu
nodemon.json ae0c347f27 Merge pull request #6542 from overleaf/jpa-em-code-sharing-workspaces 4 tahun lalu
package.json 6c21f0821c [cm6] Handle multiple selection ranges when applying snippets (#12830) 3 tahun lalu
tsconfig.json 865121259a Merge pull request #8139 from overleaf/ii-typescript-enable-strict-mode 4 tahun lalu
webpack.config.dev.js 9a5a3d4372 Merge pull request #9830 from overleaf/ae-exclude-hot-source-editor 4 tahun lalu
webpack.config.js 8b610d2d1c Use MathJax v3 on the editor page (#11330) 3 tahun lalu
webpack.config.prod.js 81816cfa2c Merge pull request #8028 from overleaf/ae-css-minimizer 4 tahun lalu
webpack.config.test.js 69a2283984 Upgrade to webpack v5 (#7249) 4 tahun lalu

README.md

overleaf/web

overleaf/web is the front-end web service of the open-source web-based collaborative LaTeX editor, Overleaf. It serves all the HTML pages, CSS and javascript to the client. overleaf/web also contains a lot of logic around creating and editing projects, and account management.

The rest of the Overleaf stack, along with information about contributing can be found in the overleaf/overleaf repository.

Running the app

The app runs natively using npm and Node on the local system:

$ npm install
$ npm run start

Running Tests

To run all tests run:

make test

To run both unit and acceptance tests for a module run:

make test_module MODULE=overleaf-integration

Unit Tests

The test suites run in Docker.

Unit tests can be run in the test_unit container defined in docker-compose.tests.yml.

The makefile contains a short cut to run these:

make test_unit

During development it is often useful to only run a subset of tests, which can be configured with arguments to the mocha CLI:

make test_unit MOCHA_GREP='AuthorizationManager'

To run only the unit tests for a single module do:

make test_unit_module MODULE=overleaf-integration

Module tests can also use a MOCHA_GREP argument:

make test_unit_module MODULE=overleaf-integration MOCHA_GREP=SSO

Acceptance Tests

Acceptance tests are run against a live service, which runs in the acceptance_test container defined in docker-compose.tests.yml.

To run the tests out-of-the-box, the makefile defines:

make test_acceptance

However, during development it is often useful to leave the service running for rapid iteration on the acceptance tests. This can be done with:

make test_acceptance_app_start_service
make test_acceptance_app_run # Run as many times as needed during development
make test_acceptance_app_stop_service

make test_acceptance just runs these three commands in sequence and then runs make test_acceptance_modules which performs the tests for each module in the modules directory. (Note that there is not currently an equivalent to the -start / -run x n / -stop series for modules.)

During development it is often useful to only run a subset of tests, which can be configured with arguments to the mocha CLI:

make test_acceptance_run MOCHA_GREP='AuthorizationManager'

To run only the acceptance tests for a single module do:

make test_acceptance_module MODULE=overleaf-integration

Module tests can also use a MOCHA_GREP argument:

make test_acceptance_module MODULE=overleaf-integration MOCHA_GREP=SSO

Routes

Run bin/routes to print out all routes in the project.

License and Credits

This project is licensed under the AGPLv3 license

Stylesheets

Overleaf is based on Bootstrap, which is licensed under the MIT license. All modifications (*.less files in public/stylesheets) are also licensed under the MIT license.

Artwork

Silk icon set 1.3

We gratefully acknowledge Mark James for releasing his Silk icon set under the Creative Commons Attribution 2.5 license. Some of these icons are used within Overleaf inside the public/img/silk and public/brand/icons directories.

IconShock icons

We gratefully acknowledge IconShock for use of the icons in the public/img/iconshock directory found via findicons.com