r/devnep • u/niyankhadka • 15h ago
Yantra – interactive, step-by-step diagrams from JSON, as one offline HTML file
Namaste everyone,
I've been building an open-source project called Yantra and wanted to share it here first and get honest feedback from the local dev community.
What it does: you write a short JSON file describing boxes, arrows and "steps", and Yantra turns it into an interactive diagram in a single HTML file. You don't place anything by hand; the layout and arrows are automatic. The reader can click through it step by step, so a system or process is explained in order instead of all at once. The file works fully offline, so you can share it on email, Viber or a pen drive.
It handles architecture diagrams, sequence diagrams, flowcharts, ER diagrams, org charts and mind maps. It can also import from Mermaid, draw.io and PlantUML.
Why it might be useful here:
- The viewer interface is available in Nepali, and there's a Nepali example diagram in the repo (a health referral flow).
- It's useful for project reports, college assignments, client handovers and documenting your system for a team.
- It works with AI tools like Claude, ChatGPT and Cursor. Ask the AI for the JSON, paste it into the playground, and you get the diagram.
- It's free and MIT licensed: no account and no tracking.
GitHub: https://github.com/niyankhadka/yantra
What I'd love help with:
- Is the Nepali translation natural, or does it sound machine-translated? Corrections are very welcome.
- What diagrams do you make often at work or in college that this should support?
- Any bugs or confusing parts in the docs.
If you find it useful, a GitHub star helps a lot with visibility. Happy to answer any questions in the comments. Dhanyabad!
