Skip to content

Commit 1eed5d8

Browse files
committed
add post for liagraph
1 parent 4ed0d71 commit 1eed5d8

2 files changed

Lines changed: 91 additions & 0 deletions

File tree

534 KB
Loading
Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
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

Comments
 (0)