{
  lib,
  stdenv,
  fetchurl,
  appimageTools,
  unzip,
  makeWrapper,
  # Notice: graphs will not sync without matching upstream's major electron version
  #         the specific electron version is set at top-level file to preserve override interface.
  #         whenever updating this package also sync electron version at top-level file.
  electron_27,
  autoPatchelfHook,
  git,
  nix-update-script,
  overrideSrc ? null,
}:
stdenv.mkDerivation (finalAttrs: let
  inherit (finalAttrs) pname version src appimageContents;
in {
  pname = "logseq";
  version = "0.10.9";

  src =
    if overrideSrc != null
    then overrideSrc
    else
      (fetchurl {
        url = "https://github.com/logseq/logseq/releases/download/${version}/logseq-linux-x64-${version}.AppImage";
        hash = "sha256-F3YbqgvL04P0nXaIVkJlCq/z8hUE0M0UutkBs2omuBe=";
        name = "${pname}-${version}.AppImage";
      });

  nativeBuildInputs =
    [makeWrapper]
    ++ lib.optionals stdenv.hostPlatform.isLinux [autoPatchelfHook]
    ++ lib.optionals stdenv.hostPlatform.isDarwin [unzip];
  buildInputs = [stdenv.cc.cc.lib];

  dontUnpack = stdenv.hostPlatform.isLinux;
  dontConfigure = true;
  dontBuild = true;

  installPhase =
    ''
      runHook preInstall
    ''
    + lib.optionalString stdenv.hostPlatform.isLinux (
      let
        appimageContents = appimageTools.extract {inherit pname src version;};
      in ''
        mkdir -p $out/bin $out/share/logseq $out/share/applications
        cp -a ${appimageContents}/{locales,resources} $out/share/logseq
        cp -a ${appimageContents}/Logseq.desktop $out/share/applications/logseq.desktop

        # remove the `git` in `dugite` because we want the `git` in `nixpkgs`
        chmod +w -R $out/share/logseq/resources/app/node_modules/dugite/git
        chmod +w $out/share/logseq/resources/app/node_modules/dugite
        rm -rf $out/share/logseq/resources/app/node_modules/dugite/git
        chmod -w $out/share/logseq/resources/app/node_modules/dugite

        mkdir -p $out/share/pixmaps
        ln -s $out/share/logseq/resources/app/icons/logseq.png $out/share/pixmaps/logseq.png

        substituteInPlace $out/share/applications/logseq.desktop \
          --replace Exec=Logseq Exec=logseq \
          --replace Icon=Logseq Icon=logseq
      ''
    )
    + lib.optionalString stdenv.hostPlatform.isDarwin ''
      mkdir -p $out/{Applications/Logseq.app,bin}
      cp -R . $out/Applications/Logseq.app
      makeWrapper $out/Applications/Logseq.app/Contents/MacOS/Logseq $out/bin/logseq
    ''
    + ''
      runHook postInstall
    '';

  postFixup = lib.optionalString stdenv.hostPlatform.isLinux ''
    # set the env "LOCAL_GIT_DIRECTORY" for dugite so that we can use the git in nixpkgs
    makeWrapper ${electron_27}/bin/electron $out/bin/logseq \
      --set "LOCAL_GIT_DIRECTORY" ${git} \
      --add-flags $out/share/logseq/resources/app \
      --add-flags "\''${NIXOS_OZONE_WL:+\''${WAYLAND_DISPLAY:+--ozone-platform-hint=auto --enable-features=WaylandWindowDecorations}}"
  '';

  passthru.updateScript = nix-update-script {};

  meta = {
    description = "Local-first, non-linear, outliner notebook for organizing and sharing your personal knowledge base";
    homepage = "https://github.com/logseq/logseq";
    changelog = "https://github.com/logseq/logseq/releases/tag/${version}";
    license = lib.licenses.agpl3Plus;
    sourceProvenance = with lib.sourceTypes; [binaryNativeCode];
    maintainers = with lib.maintainers; [cheeseecake];
    platforms = ["x86_64-linux" "aarch64-linux"] ++ lib.platforms.darwin;
    mainProgram = "logseq";
  };
})