The Lab is openingLaunch offer · $19.99 $14.99 / month
BlackRayLAB
Browse the guides
Docs/Working with source

Working with source

Download, run and edit the ready project

1. Download the ZIP

Sign in with Lab Premium and select Download code on the asset. A Free label applies to the prompt. Source downloads still require Lab Premium. Source under review means that project's download is not available yet, regardless of your plan.

View Lab Premium

2. Prepare your computer

Install Node.js 22.12 or newer with npm. Extract the ZIP and open the extracted folder in your code editor. Open its terminal and read README.md for any asset-specific instructions.

Download Node.js

3. Start the project

From the extracted folder, run these commands in order. If site contains package-lock.json, use npm ci instead of npm install. Open the local URL printed in the terminal. Keep the terminal running while you edit.

Terminal commands
cd site
npm install
npm run dev

4. Find the files to edit

The archive contains the project and its implementation brief.

  • README.md contains the setup instructions.
  • prompt.md describes the asset's design and motion.
  • site/package.json lists commands and dependencies.
  • site/src contains the React components, styles and scene logic.
  • site/public contains supplied media when the asset needs it.

5. Use it in your own app

You can edit this project directly or move the asset into an existing React app. Run the unchanged download first so you have a working reference.

  1. Copy the asset's component and the styles or helper files it imports.
  2. Install its required dependencies from site/package.json in your app.
  3. Copy its supplied media from site/public to your app's public folder, preserving the referenced paths.
  4. Render the component on your target page and check the layout and motion.
Customize and check your project