Skip to content

PR-DC/WebVSP

Repository files navigation

WebVSP — Web Vehicle Sketch Pad

Other languages: 🇷🇸 sr-Latn | 🇷🇸 sr-Cyrl | 🇫🇷 fr | 🇪🇸 es | 🇩🇪 de | 🇮🇹 it | 🇵🇹 pt

WebVSP

WebVSP is a web-first, WebAssembly-powered geometry editor for fast aircraft concept sketching ✈️. It is inspired by the rapid workflow of OpenVSP, but focused on what matters most in the earliest phase: drawing flying objects quickly with parametric building blocks.

Instead of starting from a blank CAD environment, WebVSP gives you predefined, parameterized aircraft elements (wings, fuselages, tails, and other common components). You change a few meaningful parameters (span, sweep, taper, dihedral, cross section shapes, etc.) and immediately see the result in 3D. This makes early iteration feel like sketching, but with geometry that is already structured and exportable.

A key goal is accessibility without compromise:

  • 🎓 School / students: learn aircraft geometry concepts by experimenting visually (no heavy setup, no expensive tools).
  • 🏭 Industry / teams: move faster in early design, communicate concepts clearly, and export clean geometry for review or downstream tools.
  • 🌍 Everyone: use it casually or professionally, WebVSP is designed to be practical, lightweight, and approachable.

And because WebVSP is web-first, you can run it directly in a browser - no installation required ✅. That means you can open it on almost any machine, start sketching immediately, and share results faster. (A desktop Electron build is available too, when you want a dedicated offline app.)


✨ Why WebVSP

⚙️ Fast, Parametric Aircraft Sketching

Create aircraft concepts using predefined, parameterized geometry (wings, fuselage, etc.) and iterate in seconds.

🦀 Rust/WebAssembly Performance

A Rust/WASM core powers geometry updates while keeping the UI responsive.

🌐 Works in the Browser (No Install)

Open WebVSP and start sketching immediately, ideal for classrooms, quick reviews, and lightweight workflows.

🖥️ Optional Desktop App

Electron + Three.js provide a native-feeling desktop experience when needed.

📦 Clean Exports

Export to STL and GLB for visualization and collaboration, or keep WVSP files for iteration.


✅ Status

WebVSP is currently alpha 🧪 — usable for early geometry exploration and export, but still evolving.

What works today

  • Parametric editing with live viewport updates ⚡
  • Save/load project files (WVSP) 💾
  • Export STL and GLB 📤
  • Desktop packaging via Electron 🖥️

📥 Installation

🧰 Download a packaged build

Grab the latest installer/portable build from the repo’s Releases page:


🚀 Getting Started

  1. Launch WebVSP.
  2. Add geometry from the Geom Browser
  3. Adjust parameters in the Geom Editor 🎛️ and inspect results in the viewport 👀
  4. Export to STL or GLB when you are ready to share 🔁

🛠️ Build from Source

✅ Prerequisites

  • Node.js + npm (recommended: LTS) 🟩
  • Rust toolchain (stable) 🦀
  • wasm-pack 🧩

Install Rust (if needed):

Install wasm-pack:

cargo install wasm-pack

Add WASM target (if needed):

rustup target add wasm32-unknown-unknown

▶️ Build & Run (Desktop)

npm install
npm run build
npm run dev

🌍 Optional Web Build

npm run build:web

📄 File Formats

🗂️ WVSP

Native file format: WVSP files store your parametric project state for iteration and sharing.

📦 Exports

  • STL: for 3D printing and simple downstream workflows
  • GLB: for fast visualization in web/3D viewers and sharing

🌍 Translations

The UI ships with translations for:

  • en (English) 🇬🇧
  • sr-Latn (Serbian, Latin) 🇷🇸
  • sr-Cyrl (Serbian, Cyrillic) 🇷🇸
  • fr (French) 🇫🇷
  • es (Spanish) 🇪🇸
  • de (German) 🇩🇪
  • it (Italian) 🇮🇹
  • pt (Portuguese) 🇵🇹

Localization contributions are welcome.


🤝 Contributing

PRs and issues are welcome

When opening an issue, please include:

  • Steps to reproduce
  • Logs/screenshots if relevant

Next Steps

  • CoG analysis and weight/balance tools
  • Aerodynamic analysis and reporting
  • 3D environments for project visualization
  • Expanded import/export targets for downstream CAD and CFD

License

Copyright (C) 2026 PR-DC [info@pr-dc.com](mailto:info@pr-dc.com)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see: [https://www.gnu.org/licenses/](https://www.gnu.org/licenses/)