develop-logseq-on-windows.md 2.4 KB

Build Logseq Desktop on Windows

Intro

This is a guide on creating Logseq development environment on Windows with PowerShell. Non-platform specific instructions like Develop Logseq should also be referenced.

Pre-requisites

(updated 20220218. May confirm via JAVA_VERSION and NODE_VERSION in THIS FILE)

An example of installing pre-requisites on Windows

  • Install Chocolatey
  • Install JRE
  • choco install nvm
  • nvm install 16.13 (or whatever version)
  • nvm use 16.13
  • npm install -g yarn
  • nvm use 16.13
  • Install clj-on-windows

Congrats! The pre-requisites are ready.

Set-up development environment (web app)

The basic idea is replacing the clojure commands in package.json to clj.
Go to your cloned Logseq repo. Then:

  • yarn (to install dependencies. Refer THIS if you want to setup proxy in PowerShell)
  • clj -M:cljs watch app electron (the clj equivalent of yarn cljs:watch)

Now you can access the app via http://localhost:3001 and all changes to the code will be watched.

Set-up development environment (desktop)

  • yarn
  • clj -M:cljs release app publishing electron --debug (the clj equivalent of yarn release, to build the app into static directory)
  • cd static
  • yarn
  • cd ..

Then do the gulp's job manually (as it's not available on Windows). Following commands are equivalent to yarn dev-electron-app:

  • copy files in resources to static
  • yarn css:build
  • cd static
  • yarn electron:dev

The desktop app should pop-up on your screen.

An example of setting up proxy in PowerShell

$env:GLOBAL_AGENT_HTTPS_PROXY='http://<proxy-host>:<proxy-port>'
$env:ELECTRON_GET_USE_PROXY='true'
$env:HTTPS_PROXY='http://<proxy-host>:<proxy-port>'
$env:HTTP_PROXY='http://<proxy-host>:<proxy-port>'