explaingit

mbrea-c/fibrous-docs

Analysis updated 2026-05-18

0LuaAudience · developerComplexity · 4/5Setup · moderate

TLDR

A browser based demo site that runs a real Neovim editor compiled to WebAssembly, showcasing the fibrous.nvim plugin.

Mindmap

mindmap
  root((fibrous-docs))
    What it does
      Neovim compiled to WebAssembly
      Runs fibrous.nvim plugin demo
      Static GitHub Pages site
    Tech stack
      Lua and Nix
      WebAssembly Neovim
      GitHub Actions deploy
    Use cases
      Try plugin in browser
      Benchmark performance
      Native terminal preview
    Audience
      Neovim plugin developers
      Needs JSPI capable browser

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

Try the fibrous.nvim plugin directly in a browser without installing anything.

USE CASE 2

Benchmark how fibrous performs when mounting, re-rendering, or scrolling.

USE CASE 3

Preview the fibrous homepage inside a real terminal Neovim for comparison.

USE CASE 4

Host a static WebAssembly powered Neovim demo on GitHub Pages.

What is it built with?

LuaNeovimWebAssemblyNixGitHub Actions

How does it compare?

mbrea-c/fibrous-docsalerque/silex.sileallquixotic/esoguildactivityaddon
Stars0
LanguageLuaLuaLua
Last pushed2025-04-172019-05-28
MaintenanceStaleDormant
Setup difficultymoderatemoderatemoderate
Complexity4/53/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Interactive editing requires a recent Chromium or Firefox with JSPI support enabled.

No license information was provided in the README.

In plain English

This project is a playground website for something called fibrous.nvim, a plugin for the text editor Neovim. What makes this site unusual is that it runs a real, full copy of upstream Neovim compiled into WebAssembly, a format that lets normal desktop software run inside a web browser. So visiting the site puts an actual working Neovim editor in your browser tab, with the fibrous plugin already loaded and its own landing screen built using fibrous itself. The README stresses that the whole thing is just static files: there is no server doing any computing, and it does not need certain special browser security headers that WebAssembly projects often require. Because of that, it can be hosted for free on GitHub Pages exactly as is. To run it on your own computer, the README gives a single command using Nix, a package and build tool, which serves the site locally. Interactive editing needs a newer browser feature called JSPI, supported in recent Chromium and Firefox versions, and older browsers instead see an explanation page rather than the editor. Once inside the in-browser editor, a command called Examples lists a handful of demo components you can open, such as counter, hello, form, sidebar, and panel. The project also offers a native preview mode, which runs the same homepage inside a real terminal copy of Neovim instead of the browser, plus a benchmarking mode that measures timing for things like mounting, re-rendering, and scrolling. Both can be pointed at a local copy of the fibrous plugin code for testing changes before they are published. The site itself is built and deployed automatically through GitHub Actions whenever changes are pushed to the main branch. The README notes that before automated builds work fully, two related sibling repositories need to be published first.

Copy-paste prompts

Prompt 1
Help me run this fibrous-docs playground locally using the Nix command in the README.
Prompt 2
Explain how mkNvimWasmWeb assembles the static site from the fibrous and nvim-wasm-core repos.
Prompt 3
Walk me through pointing the bench command at my own local copy of nui-reactive.
Prompt 4
Show me what I need to change in flake.nix before this project's GitHub Actions build will work.

Frequently asked questions

What is fibrous-docs?

A browser based demo site that runs a real Neovim editor compiled to WebAssembly, showcasing the fibrous.nvim plugin.

What language is fibrous-docs written in?

Mainly Lua. The stack also includes Lua, Neovim, WebAssembly.

What license does fibrous-docs use?

No license information was provided in the README.

How hard is fibrous-docs to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fibrous-docs for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.