Skip to content

README.md

Latest commit

 

History

History
122 lines (83 loc) · 3.96 KB

README.md

File metadata and controls

122 lines (83 loc) · 3.96 KB

VL-Code

VL-Code

The local AI IDE for Visual Language.
Current public runtime snapshot: VLCode Lite 1.33.7 + VL 4.1

VL / Theme / Examples  |  Quick Start & Panel Guide  |  VisualLogic Platform  |  Discord

What This Repo Covers

This repository is the public runtime-facing home for VLC:

  • how to start the latest local IDE
  • what each major panel and mode does
  • what the current shell looks like in practice
  • where to find the matching VL, theme, and importable sample packs

The language spec, theme source, and public sample zips live in VisualLogic.ai-VL.

Runtime Snapshot

Item Current public snapshot
VLC version 1.33.7
VL baseline 4.1
Default local port 4000
Primary shell modes Code, Flow, Visual, Logic, Data, Map
Embedded editors Object tree, properties, visual stage, event logic, data panels

VL-Code Code Mode

Quick Start

git clone https://github.com/VisualLogic-AI/VL-Code.git
cd VL-Code
npm install
npm run dev

Then open http://127.0.0.1:4000.

For the current public walkthrough, open docs/VLCode_Quick_Start_and_Panel_Guide.md.

Suggested First Run

  1. Start the IDE with npm run dev.
  2. Open one of the public sample packs from VisualLogic.ai-VL.
  3. Switch between Code, Flow, and Map to understand project structure.
  4. Open Visual, Logic, and Data to inspect the embedded VxEditor panels.
  5. Use the AI assistant and detail log to run generation, edits, and validation workflows.

Public Docs

Notes

  • The public shell now defaults to port 4000, not the older 3200 setup.
  • Compile, preview, and deployment flows require a valid VisualLogic platform login.
  • Public example packs, VL syntax, and the latest theme file are maintained in VisualLogic.ai-VL.

Browser Testing (Optional)

VL-Code includes Playwright-powered browser testing for visual verification:

# Install browser (one-time)
npx playwright install chromium

# Then use the browser-inspect tool in the Web IDE

Contributing

We welcome contributions! Here's how:

  • Tools (src/tools/) — add new AI tools or improve existing ones
  • Frontend (src/web/public/) — UI improvements and features
  • Examples (examples/) — share your VL projects
  • Documentation — improve docs and guides
  • Bug Reports — open issues with reproduction steps

Note: Some core engine files are protected. This does not affect your ability to extend VL-Code through the tools system, frontend, or SDK.

Related Projects

License

MIT License — see LICENSE for details.

VL-Code: Where AI meets visual programming.
Build anything. Ship everything.