A minimal, debug-first knowledge graph system built with Next.js + Prisma + PostgreSQL.

⚠️ This project is intentionally stripped down to a bare-bones UI to prioritize backend stability, data integrity, and core graph logic.

• ➕ Create Nodes
• 🔗 Create Edges (relationships between nodes)
• 📄 View Nodes (raw list)
• 🌐 View Connections
• 🧪 Debug-first UI (raw JSON responses, error visibility)

• Frontend: Next.js (minimal UI, no heavy styling)
• Backend: Next.js API routes / server actions
• Database: PostgreSQL
• ORM: Prisma

This project is currently in Engineering Mode:

• ❌ No animations
• ❌ No fancy UI
• ❌ No over-engineering
• ✅ Maximum focus on correctness
• ✅ Transparent data flow
• ✅ Fast iteration

If it works → ship If it looks good → ignore (for now)

/app
  /api
  /nodes
  /edges
/lib
  prisma.ts
/prisma
  schema.prisma

• Pages are intentionally flat and simple
• Logic may live directly inside pages (by design)
• Minimal abstraction to reduce debugging complexity

git clone https://github.com/your-username/knowledge-graph.git
cd knowledge-graph

npm install

Create .env:

DATABASE_URL="your_postgresql_connection_string"

npx prisma generate
npx prisma db push

npm run dev

Every action returns:

• Raw JSON output
• Clear error messages
• Basic loading states

Example:

{
  "id": 1,
  "title": "AI Systems",
  "connections": []
}

POST /api/nodes

GET /api/nodes

POST /api/edges

GET /api/graph

• No authentication
• No UI/UX polish
• No validation layer (minimal checks only)
• No rate limiting
• Not production-ready

• Stabilize transactions & DB performance
• Add indexing + query optimization
• Introduce connection pooling
• Graph visualization layer (later phase)
• Clean UI rebuild (post-stability)

Because premature UI optimization kills real systems.

This phase ensures:

• Backend correctness
• Scalable architecture
• Clean data relationships

Swagata Ganguly

• GitHub: https://github.com/Cyberclutch146
• LinkedIn: https://www.linkedin.com/in/swagata-ganguly-453aa6327

This is not a product yet. This is a system under construction.