CodeFlow Workspace

CodeFlow is a developer tool for visualizing architecture and impact/debug paths across frontend and backend nodes.

This repository now includes:

• Next.js dashboard app (current implementation)
• @i_am_hamza/codeflow-core package
• @i_am_hamza/codeflow-cli package

Local Development

npm install
npm run dev

Dashboard opens at http://localhost:3000 (or run npm run codeflow for port 7842).

CLI (Local Workspace Test)

After install, test local CLI directly:

npx codeflow doctor
npx codeflow init
npx codeflow dev --port 7842 --project .

codeflow dev now launches the CodeFlow dashboard and analyzes the path passed in --project (defaults to current folder).

NPM Publish Plan

1) Login

npm login

2) Publish core first

cd packages/codeflow-core
npm publish --access public

3) Publish CLI

cd ../codeflow-cli
npm publish --access public

4) User install flow (target)

npm i -D @i_am_hamza/codeflow-cli
npx @i_am_hamza/codeflow-cli dev --project .

If dashboard package resolution fails, set:

export CODEFLOW_DASHBOARD_PATH="/absolute/path/to/CodeFlow"

Config

codeflow.config.json controls analyzer scope:

{
  "analyzer": {
    "include": ["src/**/*.{ts,tsx,js,jsx}"],
    "exclude": ["**/*.test.ts", "**/*.spec.ts"]
  }
}