Protovibe Studio

A visual editor web builder for React + Tailwind apps for rapidly creating and editing web projects with your own AI agent.

Installation

Go to protovibe-studio.github.io and click "Download", then follow the instructions.

Try it in your browser

Spins up a fresh GitHub Codespace with the Protovibe template ready to run — no local install needed. Uses your personal free Codespaces quota (60 core-hours/month).

Docs

Documentation and guide: protovibe-studio.github.io/docs

Contact Protovibe Team

Got feedback or noticed a bug? Contact us at protovibe.studio@gmail.com

---

Monorepo Folder structure

protovibe-project-manager

A React + Vite app that serves as the home screen. It lets you create, duplicate, delete, and run projects. The Vite dev server also exposes a REST/SSE API (/api/projects/...) that handles spawning and monitoring project dev servers.

cd protovibe-project-manager
pnpm install
pnpm dev

protovibe-project-template && vite-plugin-protovibe (protovibe-project-template/plugins/protovibe)

The template that gets copied when you create a new project. It is a React + Vite app with Tailwind and the vite-plugin-protovibe plugin pre-wired. The plugin lives inside the template at plugins/protovibe and is consumed via a pnpm link: dependency (symlink) — the template's postinstall script handles installing the plugin's own deps and building its dist/, so a single pnpm install at the template root leaves everything ready to run.

cd protovibe-project-template
pnpm install        # also installs + builds the plugin via postinstall
pnpm dev            # just runs vite

When you are actively developing the plugin itself, run its watcher in a second terminal:

cd protovibe-project-template/plugins/protovibe
pnpm dev            # watches src, rebuilds dist/

Because the plugin is symlinked, rebuilds of plugins/protovibe/dist/ are immediately visible to the template's Vite server — no reinstall needed.

projects/

Created and managed by the project manager at runtime. Each subdirectory is an independent copy of protovibe-project-template. Do not edit these by hand — use the project manager UI instead to run the projects. When developing with coding agents, open just the single project folder.

Installation scripts

The repo also ships its own end-user installers and a desktop shortcut builder, so non-technical users can get Protovibe running without touching a terminal.

• init-installation-via-curl.sh / init-installation-via-curl.ps1 — one-liner bootstrappers that download the repo tarball into ~/Protovibe (or %USERPROFILE%\Protovibe) and then invoke the platform installer below.
• install.sh (macOS / Linux) — runs pre-flight checks, installs Node without sudo (downloads the official tarball into ~/.local/share/protovibe/ and symlinks into ~/.local/bin) if a recent enough Node isn't already on PATH, runs pnpm install for the project manager and template, and creates a path-independent shortcut that reads ~/.protovibe/project-path at runtime. Logs to install.log, lock-file guarded, with a self-test at the end.
• install.bat (Windows) — the Windows equivalent: auto-elevates for global npm install, uses winget to bring in dependencies, sets up the same path-independent shortcut, and supports an /UNATTENDED flag for the Inno Setup wrapper.
• download-newest-version.sh — self-updater that pulls fresh copies of protovibe-project-manager and protovibe-project-template from GitHub when their package.json versions are newer than the local ones. Never touches user data under projects/.

License & dual licensing

Protovibe operates under a dual-licensing model to ensure the project remains sustainable while protecting the core source code from unauthorized commercial exploitation by evil corporations.

1. The core application (AGPLv3)

The source code of the Protovibe application is licensed under the GNU Affero General Public License v3 (AGPLv3).

What this means: You are free to use, modify, and distribute the application. However, if you modify the code or include it in a larger project and offer it over a network (e.g. a SaaS product), you must make your entire project's source code open and freely available under the AGPLv3.

2. Commercial license (proprietary use)

If you are a company that wants to embed Protovibe's source code into your own commercial, closed-source product, or if your company policies prohibit the use of AGPLv3 software, you must purchase a commercial license. This license grants you the right to use Protovibe's code in proprietary environments without the obligation to open-source your own software.

📧 Contact for commercial licensing: protovibe.studio@gmail.com

3. Output exception (your designs are yours)

The AGPLv3 license applies only to the Protovibe source code itself. Any output generated by using the Protovibe application (UI designs, exported HTML/CSS, JSON data, etc.) is your property. You can use the generated outputs in any commercial, proprietary, or personal project without any restrictions, attribution, or licensing fees.

4. Third-party dependencies

Protovibe bundles third-party packages (via node_modules and similar) that retain their original licenses (MIT, BSD, Apache-2.0, etc.). The AGPLv3 terms above apply to Protovibe's own source code; downstream redistributors remain responsible for complying with the licenses of those upstream dependencies.

Contributing

See CONTRIBUTING.md. By submitting a pull request, you agree to the Contributor License Agreement, which allows the project to be re-licensed commercially.