|
| 1 | +--- |
| 2 | +title: "Mapping the LiaScript Community with LiaGraph" |
| 3 | +slug: "mapping-the-liascript-community-with-liagraph" |
| 4 | +date: 2026-04-13 |
| 5 | +draft: false |
| 6 | +image: "/images/post/liagraph/banner.png" |
| 7 | +tags: |
| 8 | + - Community |
| 9 | + - Open Source |
| 10 | + - OER |
| 11 | + - Graph |
| 12 | + - Visualization |
| 13 | +categories: |
| 14 | + - News |
| 15 | + - Feature |
| 16 | +author: "Jihad Hyadi" |
| 17 | +description: "We built an interactive network graph that maps the LiaScript open-source community — contributors, repositories, and documents — as a force-directed visualization." |
| 18 | +--- |
| 19 | + |
| 20 | +LiaScript is a distributed, open ecosystem. |
| 21 | +Courses live in GitHub repositories, contributors are spread across institutions and countries, and there is no central registry of who builds what or how it all connects. |
| 22 | +We wanted to change that — at least visually. |
| 23 | + |
| 24 | +**LiaGraph** is an interactive network graph explorer that maps the LiaScript community as a force-directed graph. |
| 25 | +It connects contributors to the repositories they work in, and repositories to the documents they contain, giving an at-a-glance picture of who is building with LiaScript and how the ecosystem clusters together. |
| 26 | + |
| 27 | +{{< button link="https://liascript.github.io/LiaGraph/" label="Open LiaGraph" >}} |
| 28 | + |
| 29 | +--- |
| 30 | + |
| 31 | +### What the graph shows |
| 32 | + |
| 33 | +The graph visualizes four types of nodes: |
| 34 | + |
| 35 | +| Shape | Color | Meaning | |
| 36 | +|-------|-------|---------| |
| 37 | +| Circle | Blue | User (1–3 repositories) | |
| 38 | +| Circle | Orange | Super-user (more than 3 repositories) | |
| 39 | +| Diamond | Pink → Purple | Repository (scaled by document count) | |
| 40 | +| Square | Green | Doc Hub (aggregated documents per repository) | |
| 41 | + |
| 42 | +Edges connect users to the documents they contribute to, and repositories to their doc hubs. |
| 43 | +Where contributors share a GitHub organization, a convex hull is drawn around them — making institutional clusters immediately visible. |
| 44 | + |
| 45 | +### Features |
| 46 | + |
| 47 | +**Force-directed layout** |
| 48 | + |
| 49 | +Nodes repel each other and edges act like springs, so highly connected contributors and repositories naturally cluster together. |
| 50 | +The layout is powered by [D3-force](https://github.com/d3/d3-force) via [AntV G6](https://g6.antv.antgroup.com). |
| 51 | + |
| 52 | +**Filter panel** |
| 53 | + |
| 54 | +Toggle which node types are visible, set a minimum repository count to focus on more active contributors, or filter by betweenness centrality to highlight the people most critical to the network's connectivity. |
| 55 | + |
| 56 | +**Org cluster toggles** |
| 57 | + |
| 58 | +Show or hide individual GitHub organization hulls to explore how different institutions relate to each other. |
| 59 | + |
| 60 | +**Node search & inspect** |
| 61 | + |
| 62 | +Search for any contributor or repository by name and jump straight to it. |
| 63 | +Click a node to see its details and connections in the sidebar, including a ranked list of the top bridge users — contributors whose removal would most fragment the network. |
| 64 | + |
| 65 | +**Minimap** |
| 66 | + |
| 67 | +A minimap in the corner lets you navigate large graphs without losing your place. |
| 68 | + |
| 69 | +--- |
| 70 | + |
| 71 | +### How it is built |
| 72 | + |
| 73 | +LiaGraph is a [React 19](https://react.dev) + [Vite](https://vitejs.dev) application. |
| 74 | +The graph itself is rendered with [AntV G6 v5](https://g6.antv.antgroup.com), and the UI components come from [Ant Design](https://ant.design). |
| 75 | + |
| 76 | +Graph data is loaded from a `graph.json` file generated by a separate data pipeline that queries the LiaScript GitHub organization and its contributor network. |
| 77 | +The app is deployed to [liascript.github.io/LiaGraph/](https://liascript.github.io/LiaGraph/) and the source is open: |
| 78 | + |
| 79 | +{{< button link="https://github.com/LiaScript/LiaGraph" label="View on GitHub" >}} |
| 80 | + |
| 81 | +--- |
| 82 | + |
| 83 | +### Why this matters |
| 84 | + |
| 85 | +The LiaScript community has grown organically across universities, research groups, and individual educators. |
| 86 | +The graph makes that growth tangible — you can see which organizations are most active, which contributors bridge otherwise separate clusters, and where new connections might form. |
| 87 | + |
| 88 | +It also serves as a practical reference: if you are looking for collaborators working on similar topics, or want to understand the structure of the ecosystem before contributing, the graph is a good starting point. |
| 89 | + |
| 90 | +We plan to keep the graph data updated regularly as the community grows. |
| 91 | +If you are building with LiaScript and your repository is not yet in the graph, make sure it is publicly visible on GitHub under a recognizable organization or user account. |
0 commit comments