whatisgithub

What is ai-linux-webapp-wrapper?

trueugenee/ai-linux-webapp-wrapper — explained in plain English

Analysis updated 2026-05-18

72JavaScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A tiny Electron template that wraps one website into a frameless desktop window on Linux, with strict security defaults.

Mindmap

mindmap
  root((repo))
    What it does
      Wraps a site in Electron
      Frameless window
      Config driven URL
    Tech stack
      Electron
      Node.js
      npm
    Use cases
      Desktop TradingView app
      Custom webapp wrapper
      Agent friendly fork
    Audience
      Vibe coders
      Linux users
    Setup
      Requires Linux
      Requires Node and npm

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a favorite website like TradingView into a standalone desktop app on Linux.

USE CASE 2

Fork the template to wrap a different site by editing one config file.

USE CASE 3

Use it as a small, readable Electron starting point to customize with a coding agent.

What is it built with?

JavaScriptElectronNode.jsnpm

How does it compare?

trueugenee/ai-linux-webapp-wrapperu7079256/paperjuryopenclaw/docs
Stars727174
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-07-09
MaintenanceActive
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencevibe coderresearcherops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Needs Node.js and npm installed on Linux before running npm install and npm start.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

This is a small Electron template that turns any website into a frameless desktop window on Linux. You set a URL in a configuration file, and the app opens that page in a dedicated window without browser toolbars, menus, or an address bar. By default it opens a TradingView chart page, but any site can be substituted by editing one JSON configuration file or by passing a URL through an environment variable before launch. The project is intentionally minimal. It is not a full app generator like Nativefier or Pake, and it is not a graphical webapp manager like Linux Mint Webapp Manager. Instead it is a small, readable template aimed at developers who want to inspect every part of the code, fork it, and customize it with a coding agent or by hand. Security defaults are conservative: the renderer process has no access to Node.js, permission requests from the page are denied, and links to sites outside the configured allowed list open in your default browser rather than inside the app window. Configuration lives in a single JSON file where you set the starting URL and list the hosts that should stay inside the app. A test suite covers the configuration loader and the URL navigation policy. A shell script can install a desktop entry and icon to your local applications menu, reading the app name and identifier from the same config file. The README also includes an example window rule for the Niri Wayland compositor and notes on running Electron under Wayland. The project requires Linux, Node.js, and npm. The license is MIT.

Copy-paste prompts

Prompt 1
Help me change the startUrl in app.config.json to point at my own dashboard site.
Prompt 2
Walk me through adding a new allowed host to this Electron wrapper's config.
Prompt 3
Explain how the url-policy.js file decides which links open inside the app versus in my browser.
Prompt 4
Help me install the desktop entry script so this app shows up in my Linux app menu.

Frequently asked questions

What is ai-linux-webapp-wrapper?

A tiny Electron template that wraps one website into a frameless desktop window on Linux, with strict security defaults.

What language is ai-linux-webapp-wrapper written in?

Mainly JavaScript. The stack also includes JavaScript, Electron, Node.js.

What license does ai-linux-webapp-wrapper use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ai-linux-webapp-wrapper to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ai-linux-webapp-wrapper for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.