revisit-studies · JackWilb · Jun 14, 2026 · Jun 10, 2026 · Jun 10, 2026 · Jun 10, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -27,6 +27,9 @@ The study configurations are defined in JSON files with schemas. These configs s
 Imported Libraries
 We provide several libraries to facilitate the development of user studies, such as vlat, mini-vlat, nasa-tlx, color-blindness, and more. These libraries are components and sequences that are defined in public/libraries/. Each library has its own folder containing the necessary code and assets. Use only libraries that exist under public/libraries/ (no ad-hoc local component imports in study configs). You can import these libraries into your study configs to enhance the functionality and user experience of your studies by adding the libraries to the top level `importedLibraries` field in the study config, and then referencing the components in the `baseComponent` field or in sequences and the sequences in the `sequences` field. When referencing the components and sequences use the following syntax `"$libraryName.components.componentName"` and `"$libraryName.sequences.sequenceName"` respectively.
 
+Large Media Assets
+Large bundled-library media should not be committed directly to this repository. Put heavyweight shared library assets in the public `revisit-studies/library-assets` repository, tag the asset release, and reference files from study/library configs with tag-pinned raw GitHub URLs such as `https://raw.githubusercontent.com/revisit-studies/library-assets/v1/...`.
+
 Storage Engines
 ReVISit supports multiple storage backends for storing study data, including Firebase and Supabase. This allows researchers to choose the backend that best fits their needs in terms of scalability, ease of use, and integration with other tools. The storage engines are abstracted in the codebase, allowing for easy addition of new storage solutions in the future. The storage engine implementations can be found in src/storage/ directory.
 

diff --git a/public/libraries/calvi/assets/questions/normal/N1.jpg b/public/libraries/calvi/assets/questions/normal/N1.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N10.jpg b/public/libraries/calvi/assets/questions/normal/N10.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N11.jpg b/public/libraries/calvi/assets/questions/normal/N11.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N12.jpg b/public/libraries/calvi/assets/questions/normal/N12.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N13.jpg b/public/libraries/calvi/assets/questions/normal/N13.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N14.jpg b/public/libraries/calvi/assets/questions/normal/N14.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N15.jpg b/public/libraries/calvi/assets/questions/normal/N15.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N2.jpg b/public/libraries/calvi/assets/questions/normal/N2.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N3.jpg b/public/libraries/calvi/assets/questions/normal/N3.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N4.jpg b/public/libraries/calvi/assets/questions/normal/N4.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N5.jpg b/public/libraries/calvi/assets/questions/normal/N5.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N6.jpg b/public/libraries/calvi/assets/questions/normal/N6.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N7.jpg b/public/libraries/calvi/assets/questions/normal/N7.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N8.jpg b/public/libraries/calvi/assets/questions/normal/N8.jpg
diff --git a/public/libraries/calvi/assets/questions/normal/N9.jpg b/public/libraries/calvi/assets/questions/normal/N9.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T1.jpg b/public/libraries/calvi/assets/questions/trick/T1.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T10.jpg b/public/libraries/calvi/assets/questions/trick/T10.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T11.jpg b/public/libraries/calvi/assets/questions/trick/T11.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T12.jpg b/public/libraries/calvi/assets/questions/trick/T12.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T13.jpg b/public/libraries/calvi/assets/questions/trick/T13.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T14.jpg b/public/libraries/calvi/assets/questions/trick/T14.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T15.jpg b/public/libraries/calvi/assets/questions/trick/T15.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T16.jpg b/public/libraries/calvi/assets/questions/trick/T16.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T17.jpg b/public/libraries/calvi/assets/questions/trick/T17.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T18.jpg b/public/libraries/calvi/assets/questions/trick/T18.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T19.jpg b/public/libraries/calvi/assets/questions/trick/T19.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T2.jpg b/public/libraries/calvi/assets/questions/trick/T2.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T20.jpg b/public/libraries/calvi/assets/questions/trick/T20.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T21.jpg b/public/libraries/calvi/assets/questions/trick/T21.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T22.jpg b/public/libraries/calvi/assets/questions/trick/T22.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T23.jpg b/public/libraries/calvi/assets/questions/trick/T23.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T25.jpg b/public/libraries/calvi/assets/questions/trick/T25.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T26.jpg b/public/libraries/calvi/assets/questions/trick/T26.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T27.jpg b/public/libraries/calvi/assets/questions/trick/T27.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T28.jpg b/public/libraries/calvi/assets/questions/trick/T28.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T29.jpg b/public/libraries/calvi/assets/questions/trick/T29.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T3.jpg b/public/libraries/calvi/assets/questions/trick/T3.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T30.jpg b/public/libraries/calvi/assets/questions/trick/T30.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T34.jpg b/public/libraries/calvi/assets/questions/trick/T34.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T35.jpg b/public/libraries/calvi/assets/questions/trick/T35.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T36.jpg b/public/libraries/calvi/assets/questions/trick/T36.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T37.jpg b/public/libraries/calvi/assets/questions/trick/T37.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T38.jpg b/public/libraries/calvi/assets/questions/trick/T38.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T39.jpg b/public/libraries/calvi/assets/questions/trick/T39.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T4.jpg b/public/libraries/calvi/assets/questions/trick/T4.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T40.jpg b/public/libraries/calvi/assets/questions/trick/T40.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T42.jpg b/public/libraries/calvi/assets/questions/trick/T42.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T43.jpg b/public/libraries/calvi/assets/questions/trick/T43.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T44.jpg b/public/libraries/calvi/assets/questions/trick/T44.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T45.jpg b/public/libraries/calvi/assets/questions/trick/T45.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T46.jpg b/public/libraries/calvi/assets/questions/trick/T46.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T47.jpg b/public/libraries/calvi/assets/questions/trick/T47.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T48.jpg b/public/libraries/calvi/assets/questions/trick/T48.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T49.jpg b/public/libraries/calvi/assets/questions/trick/T49.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T5.jpg b/public/libraries/calvi/assets/questions/trick/T5.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T50.jpg b/public/libraries/calvi/assets/questions/trick/T50.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T52.jpg b/public/libraries/calvi/assets/questions/trick/T52.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T6.jpg b/public/libraries/calvi/assets/questions/trick/T6.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T8.jpg b/public/libraries/calvi/assets/questions/trick/T8.jpg
diff --git a/public/libraries/calvi/assets/questions/trick/T9.jpg b/public/libraries/calvi/assets/questions/trick/T9.jpg
diff --git a/public/libraries/calvi/config.json b/public/libraries/calvi/config.json
diff --git a/public/libraries/vlat/assets/VLAT1.png b/public/libraries/vlat/assets/VLAT1.png
diff --git a/public/libraries/vlat/assets/VLAT10.png b/public/libraries/vlat/assets/VLAT10.png
diff --git a/public/libraries/vlat/assets/VLAT11.png b/public/libraries/vlat/assets/VLAT11.png
diff --git a/public/libraries/vlat/assets/VLAT12.png b/public/libraries/vlat/assets/VLAT12.png
diff --git a/public/libraries/vlat/assets/VLAT2.png b/public/libraries/vlat/assets/VLAT2.png
diff --git a/public/libraries/vlat/assets/VLAT3.png b/public/libraries/vlat/assets/VLAT3.png
diff --git a/public/libraries/vlat/assets/VLAT4.png b/public/libraries/vlat/assets/VLAT4.png
diff --git a/public/libraries/vlat/assets/VLAT5.png b/public/libraries/vlat/assets/VLAT5.png
diff --git a/public/libraries/vlat/assets/VLAT6.png b/public/libraries/vlat/assets/VLAT6.png
diff --git a/public/libraries/vlat/assets/VLAT7.png b/public/libraries/vlat/assets/VLAT7.png
diff --git a/public/libraries/vlat/assets/VLAT8.png b/public/libraries/vlat/assets/VLAT8.png
diff --git a/public/libraries/vlat/assets/VLAT9.png b/public/libraries/vlat/assets/VLAT9.png
diff --git a/public/libraries/vlat/config.json b/public/libraries/vlat/config.json
@@ -6,7 +6,7 @@
   "baseComponents": {
     "line": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT1.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT1.png",
       "style": {
         "width": "800px"
       },
@@ -16,7 +16,7 @@
     },
     "bar": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT2.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT2.png",
       "style": {
         "width": "800px"
       },
@@ -26,7 +26,7 @@
     },
     "stackbar": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT3.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT3.png",
       "style": {
         "width": "800px"
       },
@@ -36,7 +36,7 @@
     },
     "stackbar100": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT4.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT4.png",
       "style": {
         "width": "800px"
       },
@@ -46,7 +46,7 @@
     },
     "pie": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT5.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT5.png",
       "style": {
         "width": "800px"
       },
@@ -56,7 +56,7 @@
     },
     "histogram": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT6.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT6.png",
       "style": {
         "width": "800px"
       },
@@ -66,7 +66,7 @@
     },
     "scatterplot": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT7.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT7.png",
       "style": {
         "width": "800px"
       },
@@ -76,7 +76,7 @@
     },
     "area": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT8.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT8.png",
       "style": {
         "width": "800px"
       },
@@ -86,7 +86,7 @@
     },
     "stackarea": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT9.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT9.png",
       "style": {
         "width": "800px"
       },
@@ -96,7 +96,7 @@
     },
     "bubble": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT10.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT10.png",
       "style": {
         "width": "800px"
       },
@@ -106,7 +106,7 @@
     },
     "map": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT11.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT11.png",
       "style": {
         "width": "800px"
       },
@@ -116,7 +116,7 @@
     },
     "treemap": {
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT12.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT12.png",
       "style": {
         "width": "800px"
       },
@@ -1358,7 +1358,7 @@
       "instruction": "What is the total length of the metro system in Beijing?",
       "instructionLocation": "sidebar",
       "type": "image",
-      "path": "libraries/vlat/assets/VLAT10.png",
+      "path": "https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT10.png",
       "style": {
         "width": "800px"
       },

diff --git a/src/controllers/tests/ComponentController.spec.tsx b/src/controllers/tests/ComponentController.spec.tsx
@@ -316,6 +316,16 @@ describe('ImageController', () => {
     const { container } = render(<ImageController currentConfig={{ type: 'image', path: '/found.png', response: [] }} />);
     await waitFor(() => expect(container.querySelector('img')).toBeTruthy());
   });
+
+  test('checks absolute image URLs without prefixing them', async () => {
+    const remotePath = 'https://raw.githubusercontent.com/revisit-studies/library-assets/v1/vlat/VLAT1.png';
+    vi.mocked(getStaticAssetByPath).mockResolvedValueOnce('image-data');
+
+    const { container } = render(<ImageController currentConfig={{ type: 'image', path: remotePath, response: [] }} />);
+
+    await waitFor(() => expect(getStaticAssetByPath).toHaveBeenCalledWith(remotePath));
+    expect(container.querySelector('img')?.getAttribute('src')).toBe(remotePath);
+  });
 });
 
 // ── MarkdownController ────────────────────────────────────────────────────────

diff --git a/src/parser/tests/libraryParser.spec.ts b/src/parser/tests/libraryParser.spec.ts
@@ -6,6 +6,8 @@ import {
   ComponentBlock, DynamicBlock, LibraryConfig, StudyConfig, InheritedComponent, IndividualComponent, ParserErrorWarning,
 } from '../types';
 import { isDynamicBlock } from '../utils';
+import calviConfig from '../../../public/libraries/calvi/config.json';
+import vlatConfig from '../../../public/libraries/vlat/config.json';
 
 function isComponentBlock(value: string | ComponentBlock | DynamicBlock): value is ComponentBlock {
   return typeof value === 'object' && value !== null && 'components' in value && !isDynamicBlock(value);
@@ -1368,6 +1370,40 @@ describe('verifyLibraryUsage', () => {
 });
 
 describe('loadLibrariesParseNamespace', () => {
+  test('loads CALVI and VLAT configs with tag-pinned external image assets', async () => {
+    const libraryConfigs: Record<string, LibraryConfig> = {
+      calvi: calviConfig as LibraryConfig,
+      vlat: vlatConfig as LibraryConfig,
+    };
+
+    global.fetch = vi.fn().mockImplementation((path: URL | RequestInfo) => {
+      const pathString = path.toString();
+      const libraryName = pathString.includes('/calvi/')
+        ? 'calvi'
+        : 'vlat';
+
+      return Promise.resolve({
+        text: async () => JSON.stringify(libraryConfigs[libraryName]),
+      });
+    });
+
+    const errors: ParserErrorWarning[] = [];
+    const warnings: ParserErrorWarning[] = [];
+
+    const result = await loadLibrariesParseNamespace(['calvi', 'vlat'], errors, warnings);
+    const assetBaseUrl = 'https://raw.githubusercontent.com/revisit-studies/library-assets/v1';
+    const calviN1 = result.calvi.components['$calvi.components.N1'] as { path: string };
+    const vlatLine = result.vlat.components['$vlat.components.line-value'] as { path: string };
+
+    expect(errors).toHaveLength(0);
+    expect(result.calvi.sequences?.full).toBeDefined();
+    expect(result.calvi.sequences?.specificBank).toBeDefined();
+    expect(result.calvi.sequences?.fullBank).toBeDefined();
+    expect(result.vlat.sequences?.full).toBeDefined();
+    expect(calviN1.path).toBe(`${assetBaseUrl}/calvi/questions/normal/N1.jpg`);
+    expect(vlatLine.path).toBe(`${assetBaseUrl}/vlat/VLAT1.png`);
+  });
+
   test('loads libraries and namespaces components correctly', async () => {
     const mockLibraryConfig = {
       $schema: '',