Skip to content
rushilrawatPublic

Repository files navigation

🗺️ TechAtlas

An interactive map of software technologies and how they connect.

Explore the landscape. Follow a learning path. See where your own stack fits.

CI License: MIT Python 3.11+ React + Vite TypeScript

Explore the atlas · Run it locally


🎯 The idea

TechAtlas brings domains, concepts, and real technologies into one connected graph. Typed relationships show why nodes belong together, while the interactive atlas lets you move from a broad field to an individual tool without losing the surrounding context.

✨ Highlights

  • 🧭 Explore the graph: a radial atlas with domain sectors, semantic zoom, search, keyboard navigation, filters, and light and dark themes.
  • 🧩 Understand connections: inspect a node's neighbors, compare technologies, or follow curated guided paths through the graph.
  • 🔗 Share a view: domain, technology, and concept pages have crawlable HTML, Open Graph cards, JSON-LD, and links back into the atlas.
  • 🧪 Inspect a repository: Repo X-Ray detects a public GitHub repository's stack and highlights it in the atlas. Pre-computed example scans of well-known repositories work everywhere; scanning any repository needs the scanner backend.
  • 📚 Grow the graph carefully: curated seed data is validated before publication. Discovery assist can propose additions from Wikidata; richer relationships remain subject to human review.

📊 The graph (dataset v0.9.0)

Total nodes 3,122
Domains 40
Technologies 1,502
Concepts 1,580
Typed relationships 9,834
Relationship types 14
Curated guided paths 257
Isolated nodes 0

The largest relationship groups are related to (3,241), belongs to domain (3,082), implements (778), used for (640). Counts come from the checked-in data/graph.json and data/seed/journeys.json and are rewritten by scripts/build_dataset.py on every make data; “isolated” means a node with no incident edge.

🏗️ How it fits together

Curated seed data ──► build + validation ──► graph and layout JSON
                                            │
                               ┌────────────┴────────────┐
                               ▼                         ▼
                         FastAPI graph API       Static API snapshot
                               │                         │
                               └────────────┬────────────┘
                                            ▼
                              React + TypeScript + Sigma.js
                                            │
                                       Explore atlas

The GitHub Pages build uses the static API snapshot. The FastAPI service adds live summaries and Repo X-Ray scanning. See the architecture notes and scanner deployment guide for details.

🚀 Quick start

Requires Python 3.11+ and Node.js 20+. GNU Make is optional but convenient.

make setup
make dev

Open http://localhost:5173. The frontend runs on port 5173 and the backend on port 8000. For manual setup, port overrides, and static mode, see the development guide.

✅ Checks

make data     # rebuild and validate the graph
make test     # backend and frontend tests
make lint     # Ruff, TypeScript, and ESLint
make build    # production frontend bundle

CI also checks the backend Docker health endpoint. The Pages deployment runs a browser smoke test before publishing. See known issues and performance notes for current limitations and measurements.

📁 Repository map

Path Purpose
data/ Graph schema, curated seeds, and generated graph data
scripts/ Dataset validation, layout, discovery, and popularity tools
backend/ FastAPI graph service and repository scanner
frontend/ React, TypeScript, and Sigma.js atlas
docs/ Architecture, setup, deployment, and methodology notes

🔭 Next

AI project-to-stack recommendations are specified but not yet implemented. Repo X-Ray on the public site also depends on configuring the scanner backend; see the deployment guide.

📄 License

TechAtlas is licensed under the MIT License. The bundled font retains its own SIL Open Font License.

Releases

Packages

Contributors

Languages