Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ src-tauri/*.bak
# Node
node_modules/
pnpm-lock.yaml
package-lock.json

# MSVC
*.pdb
Expand Down
28 changes: 28 additions & 0 deletions win_leptos_fix.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
## Leptos install issue in windows

### Problem 1: Git Bash and Perl conflict

If you installed Git Bash terminal on Windows. The issue is that Git Bash ships with its own `perl.exe`, which interferes with the build process for `cargo-leptos`.

**Fix:**

* Install Strawberry Perl separately
* Add its `/bin` directory to your system PATH
* Make sure Strawberry Perl comes **before** Git Bash in PATH priority
* Use PowerShell (or another terminal) instead of Git Bash for installation so the perl you installed seperately takes priority

**Note:** The installation is time heavy by default. leptos installation can take upto 40 minutes


### Problem 2: OpenSSL setup on Windows

The Rust API guide explains OpenSSL setup for Linux and macOS, but skips Windows entirely.

**Fix:**

* Download and install OpenSSL from [Shining Light Productions (MSI installer)](https://slproweb.com/products/Win32OpenSSL.html)
* During setup, select: “The OpenSSL binaries (/bin) directory”
* Add this to PATH:
`C:\OpenSSL-Win64\bin`
* Create an environment variable:
`OPENSSL_DIR = C:\OpenSSL-Win64`