The Problem
Teams and individuals need a shared visual workspace for brainstorming, diagramming, and planning. Existing whiteboard tools are either too simple for real work or locked behind subscription paywalls. Neoflow addresses this by combining a full-featured drawing canvas with team-based project organization and AI-assisted diagram generation in a single open-source application.
What This Does
Neoflow is a multi-tenant whiteboard application built on Next.js and the tldraw engine. The core editor lives in components/Tl/editor.jsx with supporting toolbars, zoom controls, and a Mermaid-based flowchart generator in components/Tl/Mermaid/. The app supports both solo projects (app/api/soloProjects/) and team-based collaboration (app/api/team/), with role management and invitations handled through API routes.
The AI integration routes through app/api/gpt/ and app/api/chat/, with specialized endpoints for SQL generation and syntax-aware diagram creation (app/api/gpt/sql/route.ts, app/api/gpt/syntax/). Authentication uses NextAuth (app/api/auth/[...nextauth]/), and the data layer is Prisma (prisma/schema.prisma). The UI is composed of 30+ shadcn-style components under components/ui/.
How To Use It
Setup: Clone the repo and install dependencies with npm --force i (the --force flag is in the README, indicating dependency conflicts exist). Copy .env.example to .env and fill in the required values.
Configuration: The .env.example file defines the necessary environment variables. The Prisma schema implies a database connection string. No documentation exists beyond the README, so exact variable names must be inferred from .env.example and the API routes.
Running it: Start the development server with npm run dev and open http://localhost:3000. The main entry point is app/page.jsx which routes to the home landing page and the authenticated app area.
git clone https://github.com/kiraaziz/Neoflow.git cd Neoflow cp .env.example .env npm --force i npm run dev
Real-World Use
A design team can create a shared workspace, invite members through the invitation system (app/api/team/invitation/route.ts), and collaborate on a project board in real time. When a developer needs to document an API flow, they can paste a natural-language description into the Mermaid tool and get a rendered sequence diagram without leaving the whiteboard.
Code Health & Issues
High - No test files detected - The entire codebase has zero tests. The editor, collaboration features, and AI routes are untested, making regressions likely during development. High - No CI/CD pipeline - No .github/ directory or CI config exists. There is no automated build or test gate, so broken code can reach production. Medium - No LICENSE file - The README claims MIT License, but no LICENSE file exists in the repository root. This creates legal ambiguity for downstream use. Medium - Auth session handling - app/api/auth/[...nextauth]/Options.ts and the session provider (components/providers/Session.jsx) suggest session logic is present, but without tests or documentation the security posture is unverified. Low - Force install flag - The README's npm --force i suggests dependency conflicts exist. This is a maintenance smell that should be resolved at the package.json level.
The Bottom Line
Neoflow is a functional whiteboard with real collaboration features and a clever AI diagramming integration. The absence of tests, CI, and a license file makes it risky for production adoption, but it is a solid foundation for a team willing to invest in hardening. It is better suited as a reference implementation or internal tool than a customer-facing product in its current state.