diff --git a/src/content/open-source/guides/build-from-sources.mdx b/src/content/open-source/guides/build-from-sources.mdx
index a86b632..bd0d414 100644
--- a/src/content/open-source/guides/build-from-sources.mdx
+++ b/src/content/open-source/guides/build-from-sources.mdx
@@ -3,44 +3,38 @@ title: Build from sources
description: Lightpanda is written with Zig@0.14.0. You will have to install it with the right version in order to build the project.
---
+import { Callout } from 'nextra/components'
+
# Build from sources
## Prerequisites
Lightpanda is written with [Zig](https://ziglang.org/) `0.14.0`. You will have to
install it with the right version in order to build the project.
+
+You need also to install [Rust](https://rust-lang.org/tools/install/) for building deps.
+
Lightpanda also depends on
[zig-js-runtime](https://github.com/lightpanda-io/zig-js-runtime/) (with v8),
-[Netsurf libs](https://www.netsurf-browser.org/) and
-[Mimalloc](https://microsoft.github.io/mimalloc).
+[Libcurl](https://curl.se/libcurl/) and [html5ever](https://github.com/servo/html5ever).
To be able to build the v8 engine for zig-js-runtime, you have to install some libs:
**For Debian/Ubuntu based Linux:**
```bash copy
-sudo apt install xz-utils \
- python3 ca-certificates git \
- pkg-config libglib2.0-dev \
- gperf libexpat1-dev unzip rsync \
- cmake clang
+sudo apt install xz-utils ca-certificates \
+ pkg-config libglib2.0-dev \
+ clang make curl git
```
**For MacOS, you need [Xcode](https://developer.apple.com/xcode/) and the following pacakges from homebrew:**
```bash copy
-brew install cmake pkgconf
+brew install cmake
```
-## Install and build dependencies
-
-### All in one build
-
-You can run `make install` to install deps all in one (or `make install-dev` if you need the development versions).
-
-Be aware that the build task is very long and cpu consuming, as you will build from sources all dependencies, including the v8 Javascript engine.
-
-### Step by step build dependency
+## Install Git submodules
The project uses git submodules for dependencies.
@@ -49,44 +43,41 @@ To init or update the submodules in the `vendor/` directory:
```bash copy
make install-submodule
```
-#### Netsurf libs
-
-Netsurf libs are used for HTML parsing and DOM tree generation.
-```bash copy
-make install-netsurf
-```
+This is an alias for `git submodule init && git submodule update`.
-For dev env, use `make install-netsurf-dev`.
+## Build and run
-
-#### Mimalloc
+You an build the entire browser with `make build` or `make build-dev` for debug
+env.
-Mimalloc is used as a C memory allocator.
+But you can directly use the zig command to run in debug mode:
```bash copy
-make install-mimalloc
+zig build run
```
-For dev env, use `make install-mimalloc-dev`.
-
-Note: when Mimalloc is built in dev mode, you can dump memory stats with the
-env var `MIMALLOC_SHOW_STATS=1`. See
-[https://microsoft.github.io/mimalloc/environment.html](https://microsoft.github.io/mimalloc/environment.html).
-
-
-#### v8
+
+ The build will download and build V8. It can takes a lot of time, more than
+ 1 hour.
+ You can save this part by donwloading manually a
+ [pre-built](https://github.com/lightpanda-io/zig-v8-fork/releases version)
+ and use the `-Dprebuilt_v8_path=` option.
+
-Lightpanda browser depends on v8 Javascript engine.
+### Embed v8 snapshot
-This build task is very long and cpu consuming, as you will build v8 from sources.
+Lighpanda uses v8 snapshot. By default, it is created on startup but you can
+embed it by using the following commands:
+Generate the snapshot.
```bash copy
-make get-v8
+zig build snapshot_creator -- src/snapshot.bin
```
+Build using the snapshot binary.
```bash copy
-make build-v8
+zig build -Dsnapshot_path=../../snapshot.bin
```
-For dev env, use `make build-v8-dev`.
+See [#1279](https://github.com/lightpanda-io/browser/pull/1279) for more details.