Skip to content

About

A local-first visual editor for React and report design. Inspect JSX/TSX, edit components with drag-and-drop, and save validated changes back to source. Includes Report Studio with native report editing and experimental YRF support.

Topics

Resources

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

25 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

React UI/UX Tool

TypeScript Node.js License: MIT Local first

A local-first visual editor and UI builder for React. Inspect real JSX/TSX, preview supported applications, and turn drag-and-drop changes into validated source edits that stay easy to review with Git.

Best for: React teams that want a visual workflow without replacing their existing codebase with a proprietary page format.

Bahasa Indonesia · English user guide · Panduan Bahasa Indonesia · Compatibility · Known limitations · Benchmarks · License · Third-party licenses · Changelog · Inspiration & credits · GitHub

Version 0.1.0, prepared for local testing. The package has not been published to npm. Source remains ordinary React code; there is no hidden page schema replacing an existing application.

Running local Studio with the demo canvas and inspector

Report Studio: design and update reports

Report Studio is a separate workspace on Home for creating reports or opening an existing report folder. You can also enter it from Reports in an open React project. It works locally with the report files you choose.

Report Studio launcher with Open existing and Create new

Report Studio design canvas and properties

flowchart LR
  Home[Home: Report Studio] --> Start[Open existing or Create new]
  Start --> Folder[Choose report folder]
  Folder --> Open[Pick a report from one list]
  Folder --> New[Pick a template]
  Open --> Design[Design: select, drag and resize]
  New --> Design
  Design --> Palette[Palette + alignment/layers/properties]
  Palette --> Save[Single Save in place]
  Save --> Check[Preview and check output]
Loading

Workspace map (illustration):

┌─────────────────┬──────────────────────────┬────────────────────┐
│ Reports/Palette │ Design · Code · Preview  │ Properties         │
│ Choose report   │                          │ Text, size, color  │
│ Text / Field    │     Report page          │ Data binding       │
│ Box / Line      │     select and drag      │ Save / Remove      │
└─────────────────┴──────────────────────────┴────────────────────┘

Try it in five steps:

  1. Choose Report Studio on Home, then Open existing report or Create new report.
  2. Choose your report folder and select a report from the list, or choose a template.
  3. In Design, select an object. Use the left palette to add objects by click or drag-and-drop, and the right inspector to change supported values and dimensions.
  4. Use Code to inspect or edit supported source, and Preview to check native output with sample data. Save your changes before leaving.
  5. For native reports, choose Save and optionally export PDF, HTML, CSV, XLSX, or DOCX. For .yrf, the same Save updates the opened original in place for supported caption, data-field, geometry, style, structure and source edits, with a content-hash conflict check and no backup or .edited copy.
  6. Use Alignment and Layers in the inspector: layers are grouped by band, topmost first, and selecting a row edits that object even when it is covered on canvas.
Format What you can do What to check
Native .report.json Create and open designs; edit text, fields, tables and other supported objects; preview and export. Export formats have different limitations; review warnings, rows and totals.
WaiReport .yrf Open existing files; edit supported values, style, structure and source drafts; one Save writes the same opened file. Save is in-place with a hash conflict check and no backup; unsupported/scripted objects are refused. Design is approximate and vendor rendering is unverified. Validate in WaiReport before business use.
PDF, HTML, CSV, XLSX, DOCX Export native reports to these formats. They are output files, not interchangeable editable report designs; fidelity varies.

See the step-by-step Report Studio guide, format capabilities, known limitations, and the release and recovery checklist.

What it does

Two workspaces ship today: the React project editor and Report Studio, a local-first native report designer (.report.json) with professional templates, canvas editing, and print preview. PDF, HTML, CSV, XLSX, and DOCX exports support limited subsets. The experimental .yrf inspector can save edited copies or create new files; these have not been validated with the vendor renderer.

  • Opens a React project without running it, then explains what was found.
  • Opens up to three page/component tabs; tab switches preserve selection, inspector and zoom.
  • Selects logical compound controls (Form.Field, date/range) and supports Cmd/Ctrl+click multi-selection with one-step group movement.
  • Shows real screens and reusable components after one explicit Start local preview click.
  • Adds, copies, moves, aligns, edits, and deletes supported visual objects.
  • Saves supported changes directly to normal JSX/TSX and keeps one safe Undo step.
  • Keeps business screens in Pages and shows only reusable visual items in Components.
  • Works locally with no cloud sign-in or automatic Git push.
flowchart LR
  A[Open project] --> B[Read the report]
  B --> C[Start local preview]
  C --> D[Select or add an object]
  D --> E[Edit, move, align, or delete]
  E --> F[Source is checked and saved]
  F --> G[Review and test with Git]
Loading

Requirements and quick start

Node.js 24 is recommended; the package requires Node >=22.12.0. This implementation was exercised on macOS with Node 24.22.1. Windows/Linux checks are defined in CI but must pass there before those platforms are described as verified. Use a current desktop browser. No Docker, Electron, database, cloud account, or paid API is needed.

cd /path/to/react-uiux-tool
npm install
npm run build
npm start

Open the http://127.0.0.1:<port> URL printed in the terminal. Stop Studio and its managed preview with Ctrl+C. Closing a browser tab does not stop Node. For source development, use npm run dev instead of npm start.

# Read-only project report; does not start the target application
node dist/cli.js analyze ./fixtures/demo --json
# Open a chosen project in Studio
node dist/cli.js open /absolute/path/to/react-project
node dist/cli.js --help

Try the draft editing workflow

  1. Choose English or Bahasa Indonesia, then open a trusted existing React project.
  2. Review the project report and explicitly start the local preview.
  3. Select a fixed element in Design mode. In Props, change a supported value and choose Apply to draft. The source file is unchanged until you choose Save.
  4. Select a container in Pages, then add a reusable component or basic visual element from Components. You can also drag it directly onto the picture.
  5. Drag selected objects, use the alignment icons, Delete/Backspace to remove, and Command/Ctrl+Z to undo a draft change. Choose Preview draft to refresh the canvas, then Save to write the source or Discard Draft to cancel. In a real project, review the resulting files through Git before pushing.

New and existing projects

New Project creates a Vite + React + TypeScript application in a chosen empty folder. Templates: Blank, Business Dashboard, Data Entry/Form, and Operations Console. Styling: plain CSS, CSS Modules, or Tailwind v4. Review the file/dependency plan first. Creation writes files only; run npm install and npm run dev yourself when ready. Do not select Next.js for creation in this release.

Open Existing Project accepts a native directory picker where available, or an absolute path. The first analysis is read-only: framework/routes, source elements, component and import evidence, literal props, behavior, styling, editability, Git state, scan coverage, and limitations. Analysis never executes application code.

Clicking Start local preview is the single approval action; there is no second modal. The preview supports conventional Vite/React applications with an index.html entry. It adds source metadata in memory, without editing the project. It deliberately bypasses target scripts and dynamic Vite/PostCSS configuration. Common tsconfig/jsconfig and literal Vite/Webpack aliases are read statically; selecting a discovered component opens a separate Design view and finds direct local context providers used through hooks. Dynamic aliases, custom plugins, nested runtime setup, assets, or environment variables may still need manual setup. Next.js App/Pages projects support static inspection; Next runtime source selection is not implemented. See the matrix.

Editing boundaries

  • Supported fixed text, props, classes, and inline styles produce small source changes. Basic element insertion can set checked values and reference an existing in-scope event function; it never invents handler business logic. Hooks and unrelated comments/imports stay source-owned.
  • Supported fixed structures allow insertion, movement, alignment, and removal, with keyboard alternatives. Dynamic, conditional, repeated, or unclear objects are locked rather than rewritten speculatively.
  • Only reusable visual project components appear in Components; business views, pages, screens, and routes remain in Pages. Dragging a reusable component into a supported container adds its JSX and import. A selected JSX section can be copied while changing a literal id, name, fromName, toName, or *Id value.
  • The inspector derives safe component contracts from TypeScript props and JavaScript destructuring defaults. It can add literal string/number/boolean props, constrain union values, and bind declared callback events to existing in-scope functions. React methods and new handler logic remain source-owned.
  • Supported visual edits stage in a non-blocking draft; Changes lists the affected objects and follows Undo/Redo. Save commits the draft with analyzed hash/path checks and conflict-aware history; Save & Build additionally runs the project build. Review the resulting files with Git before pushing; no commit or push is automatic.

Reusable project components and friendly visual elements

Product tour

Start and learn Check before running
Home and User Guide Project check
Interactive guide Visual editing
Interactive guide Canvas and Inspector
Report launcher Report editing
Report Studio launcher Report Studio canvas

English/Indonesian and light/dark/system settings are available in the header. Studio theme changes do not rewrite application CSS. All help links open bundled local docs.

Safety and privacy

The controller binds only to 127.0.0.1 and checks session authorization, Host, and Origin. Analysis does not run project code or inspect excluded secret files. Preview executes app source after approval. Isolated component Design redirects fetch/XHR service requests to an empty local mock; other mount effects and application network calls are not sandboxed. Preview runs only after an explicit Start local preview click. Use trusted test projects. There is no telemetry, auto-commit, push, or deployment. Read SECURITY.md before changing the local trust model.

Development and validation

npm run typecheck
npm test
npm run build
# First-time browser setup, if Chromium is not installed:
npx playwright install chromium
npm run test:e2e
npm run benchmark

src/engine owns analysis and source patches; src/server owns the protected local controller and preview; src/templates generates files-only starters; studio/src contains React UI and catalogs; fixtures/demo provides a local teaching project. Review IMPLEMENTATION_STATUS.md for recorded verification.

Roadmap

Next runtime adapter, broader component-library schemas, route discovery for page tabs, zero-reload draft sync, Storybook argument import, global-token edits, visual regression, and a thin VS Code extension remain follow-up work. They are not shipped claims.

Inspiration & Credits

Independent work inspired by Y[wai] / waiVSCode, Codux, Onlook, Puck, Storybook, React Grab, Craft.js, SculptUI, and Plasmic. The design brief also references ts-morph, Recast, and dnd-kit. These projects are not sponsors or affiliates. The detailed inspiration record explains what was learned and what is not included. See NOTICE.md for provenance and the generated third-party inventory for every locked package version and license. Original implementation: MIT © 2026 RA.

Workspace guides

Use the English guide or panduan Indonesia for illustrated React editing, report design, palette, data, saving and troubleshooting. Report Studio supports native reports and experimental .yrf editing; see format limitations before relying on vendor output.

About

A local-first visual editor for React and report design. Inspect JSX/TSX, edit components with drag-and-drop, and save validated changes back to source. Includes Report Studio with native report editing and experimental YRF support.

Topics

Resources

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages