99-reference/finding-framework-files.md

Finding framework files

Finding framework files

Use this file when you need to locate Vroq framework or system files referenced by app code.

Main rule

Application code and framework code may live in different appids.

When an app imports files using paths like:

import { mount } from "/vroqjs/runtime.js";
import { Button } from "/vroqjs/components/Button.js";

those framework files are not part of the target app itself. They live in the framework app.

Where framework files live

Framework and system files imported through /vroqjs/... live in:

• appid: vroq
• directory root: vroqjs/

How to find the active framework version

The framework version is defined in the app's app.json file.

Example:

{
  "version": 1,
  "vroqjs": "v01"
}

The value of vroqjs determines the framework version.

If a prompt does not specify a version, default to:

• v01

The version is then referenced from index.html using {{app.vroqjs}}.

How to inspect framework files

If the target app imports /vroqjs/..., then:

1. read the app's index.html 2. find the /vroqjs/ import mapping 3. identify the framework version such as v01 4. inspect files in:

appid: vroq
path: vroqjs/<version>/...

Example:

• app import: /vroqjs/components/Button.js
• version from index.html: v01
• actual framework file to inspect:

appid: vroq
vroqjs/v01/components/Button.js

What belongs to the app vs the framework

Usually:

• target app code lives in that app's own appid
• shared framework/system code lives in appid vroq
• app-local imports often use relative paths or @app/
• framework imports use /vroqjs/...

Final rule

When debugging or modifying an app, always distinguish between:

• app files in the target appid
• framework files in appid vroq

Use index.html to determine which vroqjs version is active before reading framework code.