DJ Tools

Reusable browser-based tools that run locally on the user's device.

Tools

Image to WebGL

Convert transparent PNG artwork into a textured, extruded 3D object, preview it interactively with Three.js, and download it as a self-contained GLB.

• Source: apps/image-to-webgl
• No image uploads or hosted conversion service
• Adjustable depth, edge width, color blending, and curvature
• Light and dark preview environments

Development

Requirements:

• Node.js 22.12 or newer
• npm
• Microsoft Edge for the optional browser smoke test

Install and run the first tool:

npm install
npm run dev

Validation:

npm run typecheck
npm test
npm run build

With the development server running in another terminal:

npm run test:browser

GitHub Pages

The repository includes a Pages workflow that publishes a tool catalog at the site root and each app under its own path. It runs from main and remains inactive until this local work is committed and pushed and GitHub Pages is configured to use GitHub Actions as its source.

The planned public URL is:

https://darrenjohns.github.io/djtools/

The first tool will be available at:

https://darrenjohns.github.io/djtools/image-to-webgl/

Adding another tool

Add each future application under apps/ as its own npm workspace, then expose convenience scripts from the root package.json.

License

MIT