Dev environment

Toolchain versions

Tool	Version	Where it is pinned
Flutter	3.47.5	scripts/linux/flutter.version
Dart	^3.13.4	app/pubspec.yaml (comes with Flutter)
Rust	1.99.0	rust-toolchain.toml in LEPIC
Rust, fuzzing	nightly-2026-10-02	fuzz/rust-toolchain.toml in LEPIC
Android NDK	28.2.13676358	tools/env.sh
JDK	21	tools/env.sh (Android code targets Java 17)
cargo-ndk	4.1.2	LEPIC's mobile CI workflow
Xcode	26 or newer	tools/build-apple.sh doctor
Ubuntu (Linux release build)	22.04	scripts/linux/Dockerfile

Check these files for the current values before you install; the table follows them. With rustup installed, entering a LEPIC checkout installs the pinned Rust and the targets it lists (Android and iOS) by itself.

LEPIC has no other Rust or Dart requirements. lepic-flutter needs Flutter 3.47.0 or newer and generates its bridge with flutter_rust_bridge 2.13.0.

tools/env.sh

Source it, do not run it:

. tools/env.sh

It sets user-space paths only; nothing needs sudo. Edit the paths at the top of the file if your tools live elsewhere, or set a variable again after sourcing.

Variable	Default
JAVA_HOME	a JDK 21 under ~/.local/opt
ANDROID_HOME, ANDROID_SDK_ROOT	~/Android/Sdk
ANDROID_NDK_VERSION	28.2.13676358
ANDROID_NDK_HOME, ANDROID_NDK_ROOT	$ANDROID_HOME/ndk/$ANDROID_NDK_VERSION
FLUTTER_ROOT	~/flutter

It also puts ~/.cargo/bin, ~/.pub-cache/bin, the Android SDK tools, Flutter and the JDK on PATH.

First build

. tools/env.sh
tools/lepic.sh sync
tools/lepic.sh build linux
cd app && flutter pub get && flutter analyze

The full steps are on Build from source.

LEPIC

git clone https://github.com/BTLabs-EPIC/lepic.git
cd lepic
cargo xtask check

Run cargo xtask without arguments to list the commands. See Testing.

To try a LEPIC change in the app, point LEPIC_REPO at your clone. The pin in tools/lepic.rev must name a commit that exists there, and lepic-flutter's own lepic.rev must name the same commit. See lepic-flutter.

Editors

• Flutter app: open app/ in VS Code with the Dart and Flutter extensions, or in Android Studio or IntelliJ with the Flutter plugin. Point the SDK path at the Flutter version above.
• Rust: open the LEPIC folder with rust-analyzer. The repository's .editorconfig sets UTF-8, LF line endings, a final newline, four-space indents, and two for Markdown, YAML, JSON and TOML.
• Format and lint before you commit: cargo fmt and cargo clippy for LEPIC, dart format and flutter analyze for the app.
• Linux desktop runs need the GTK 3 and libsecret development packages, plus clang, cmake, ninja-build and pkg-config.