# lok-wasm

**Repository Path**: btoo7/lok-wasm

## Basic Information

- **Project Name**: lok-wasm
- **Description**: LibreOffice Kit WASM builds  
https://github.com/chase/lok-wasm
- **Primary Language**: Unknown
- **License**: MPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LOK WASM

This is a public project that forks LibreOffice to provide functionality and fixes that don't fit in [the upstream project](https://github.com/LibreOffice/core).

It also provides a simple to setup environment for working on LOK as a WASM-based app. This was originally developed for [Macro](https://macro.com) and released to the public on 18 Feb 2024.

All changes are open sourced under the [Mozilla Public License 2.0](LICENSE).

This project is not a part of the official LibreOffice project, nor endorsed by the Document Foundation.

# Prerequisites

## macOS

Install [OrbStack](https://orbstack.dev/download)

Clone the repo and enter the dev environment:

```bash
git clone https://github.com/coparse-inc/lok-wasm
./in-docker
```

## Linux with Podman

Clone the repo and enter the dev environment:

```bash
git clone https://github.com/coparse-inc/lok-wasm
./in-podman
```

## Linux with Docker

Clone the repo and enter the dev environment:

```bash
git clone https://github.com/coparse-inc/lok-wasm
./in-docker
```

## Ubuntu/Debian/Pop_OS!

```bash
apt-get install -y --no-install-recommends \
  git \
  build-essential \
  zip \
  nasm \
  python3 \
  python3-dev \
  autoconf \
  gperf \
  xsltproc \
  libxml2-utils \
  bison \
  flex \
  pkg-config \
  ccache \
  openssh-server \
  cmake \
  sudo \
  locales \
  libnss3
```

Setup the repo:

```bash
git clone https://github.com/coparse-inc/lok-wasm
./scripts/setup
```

# Building

```bash
# Run configure for the initial build or any configuration changes
./scripts/configure dev
# if you're using VS Code or clangd in vim, run this
./scripts/clangd
# Run build for any code changes
./scripts/build
```

# QA Env

Make a build first, then:

```bash
./scripts/launch-qa
```

# Debugging

Make a debug build:

```bash
# Clean the existing build
(cd libreoffice-core/ && make clean)
# Run configure for debug
./scripts/configure debug
# Run build for any code changes
./scripts/build
```

If you're debugging the QA environment with `./scripts/launch-qa`, the included LOK C++ debugging extension should be included.

Otherwise use Chrome with [the C/C++ WASM debugging tools extension](https://goo.gle/wasm-debugging-extension) installed.

Use Ctrl/Cmd+P in the Dev Tools to quickly navigate to the `.cxx` file you need to debug.

You can add breakpoints as necessary in the Dev Tools, but conditional breakpoints still aren't supported.  
If you need to add a conditional breakpoint, use an if statement with a log to set a break point on inside of your code:  
```
if (myCondition == true) {
    SAL_WARN("debug", "here");
}
```


Expand the LOK logs to see the full stack trace, clicking on the `.cxx` file will jump to the source for the file.

# Docs

<!-- TIP: in neovim, you can use `gf` to go to the file linked if the cursor is between ( ) -->

- [Important Files](./important_files.md)