# Dev builds of JupyterLite and extensions, individually and combined

Ian Thomas 2024-05-21. Tested using `conda` on Ubuntu as I don't trust the alternative `micromamba` and macOS combination.

# JupyterLite

1. `cd <somedir>`
2. `git clone [e-mail]:jupyterlite/jupyterlite.git`
3. `cd jupyterlite`
4. Add `console.log("==> Hello");` line to `packages/server-extension/src/index.ts` in `contentsPlugin.activate` for example. This is so we can identify when running this branch rather than the latest PyPI/conda package.
5. `conda env create -f .binder/environment.yml`
6. `conda activate jupyterlite-dev`
7. `jlpm`
8. `jlpm build`
9. `jlpm serve`
10. Open browser at http://127.0.0.1:5000/ and check console output for ``"==> Hello"``.
11. Works fine.

# JupyterLite extension

1. `cd <somedir>`
2. `git clone [e-mail]:ianthomas23/jupyterlite-terminal.git`
3. `cd jupyterlite-terminal`
4. `git checkout origin/comment_out_terminal_tracker`
5. `conda create -n jupyterlite-terminal python=3.11`
6. `conda activate jupyterlite-terminal`
* May need to `conda install -c conda-forge yarn`
8. `pip install jupyterlab jupyterlite-core`
9. `pip install -ve .`
10. `jupyter labextension develop . --overwrite`
11. `jlpm build`
12. `jupyter lite build`
13. `jupyter lite serve`
14. Open browser at http://127.0.0.1:8000/index.html and check console for `"==> Terminals constructor".`
15. Works fine.

# Combined 1, run from JupyterLite directory

1. `cd <somedir>/jupyterlite`
2. `git clean -fxd`
3. `conda env create -f .binder/environment.yml -n combined1`
4. `conda activate combined1`
5. `jlpm`
6. `jlpm build`
7. `cd <somedir>/jupyterlite-terminal`
8. `git clean -fxd`
9. `pip install -ve .`
10. `jupyter labextension develop . --overwrite`
11. `jlpm build`
12. `cd <somedir>/jupyterlite`
13. `jlpm serve`
14. Open browser at http://127.0.0.1:5000/.
15. Only have the `"==> Hello"`, not the `"==> Terminals constructor"`.

# Combined 2, run from extension directory

1. `cd <somedir>/jupyterlite`
2. `git clean -fxd`
3. `conda env create -f .binder/environment.yml -n combined2`
4. `conda activate combined2`
5. `jlpm`
6. `jlpm build`
7. `cd <somedir>/jupyterlite-terminal`
8. `git clean -fxd`
9. `pip install -ve .`
10. `jupyter labextension develop . --overwrite`
11. `jlpm build`
12. `jupyter lite build`
13. `jupyter lite serve`
14. Open browser at http://127.0.0.1:8000/index.html
15. Only have the `"==> Terminals constructor"``, not the "==> Hello"`.