@crapthings/run3d 0.2.4 → 0.2.6

package/README.md

@@ -1,12 +1,12 @@
 # run3d
 
-Create a 3D project in one command. The starter scene has a grid and a box ready to edit.
+Create a 3D project in one command. The starter scene recreates the run3d icon with a green cube and speed lines, ready to edit.
 
 As models like GPT-6 Astra grow more capable at building 3D experiences, the distance from an idea to a working prototype keeps shrinking. I have new ideas every day, and I want to spend that energy creating. run3d brings my go-to tools for brainstorming and experimentation into one ready-to-use starter, so I can jump straight into building, testing ideas, and discovering what works.
 
 ## Usage
 
-Requires Node.js `^20.19.0 || >=22.12.0` and pnpm.
+Requires Node.js `>=22.22.0` and pnpm.
 
 ```bash
 npx @crapthings/run3d my-project
@@ -14,7 +14,9 @@ cd my-project
 pnpm dev
 ```
 
-Edit `src/Scene.jsx` to make it your own. To install dependencies later, add `--skip-install` to the first command.
+Edit the components in `src/Scenes` to make the starter scene your own. To install dependencies later, add `--skip-install` to the first command.
+
+Drag to orbit the scene, scroll to zoom, and right-drag to pan. Edit `src/Scenes/index.jsx` for the scene and its settings.
 
 ## Included tools
 
@@ -52,5 +54,6 @@ Edit `src/Scene.jsx` to make it your own. To install dependencies later, add `--
 
 - [React Router](https://github.com/remix-run/react-router) — connects URLs to pages and handles navigation.
 - [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss) — styles the app.
+- [React Hotkeys Hook](https://github.com/JohannesKlauss/react-hotkeys-hook) — adds declarative keyboard shortcuts with a React hook.
 - [Headless UI](https://github.com/tailwindlabs/headlessui) — provides accessible, unstyled React UI components.
 - [Floating UI](https://github.com/floating-ui/floating-ui) — positions menus, tooltips, and popovers.

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "From idea to interactive 3D prototype in one command. A JavaScript starter with Vite, React Three Fiber, and tools for creative experimentation.",
   "type": "module",
   "bin": {
@@ -18,11 +18,12 @@
     "template/npmrc",
     "template/package.json",
     "template/pnpm-lock.yaml",
+    "template/public",
     "template/src",
     "template/vite.config.js"
   ],
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.22.0"
   },
   "scripts": {
     "lint": "standard \"bin/**/*.js\" \"scripts/**/*.js\" \"test/**/*.js\" \"template/src/**/*.{js,jsx}\" template/vite.config.js",

package/template/AGENTS.md

@@ -2,12 +2,19 @@
 
 ## Commands
 
-- Only run `pnpm build`, `pnpm lint`, or `pnpm test` when explicitly requested by the user.
+- Only run `pnpm build`, `pnpm lint`, or `pnpm test` when explicitly requested by the user, and never run `pnpm dev`.
 
 ## Code Style
 
 - Follow JavaScript Standard Style (standard.js) when writing `.js` and `.jsx` files.
+- Explain each top-level declaration's purpose in a one-sentence comment; split it if one sentence cannot explain it clearly.
+- Avoid overengineering: question whether each solution or abstraction is needed for current requirements before implementing it.
+- Write component styles inline with Tailwind utilities in `className`, using arbitrary values when needed; use CSS files only for global setup or styles Tailwind cannot express.
 
 ## Scene Lighting
 
 - Avoid ambient lighting by default. Only add ambient lighting (such as `AmbientLight` or `HemisphereLight`) when explicitly requested by the user.
+
+## Texture Maps
+
+- When using texture maps, process them with the installed `three-hex-tiling` package to reduce visible texture repetition instead of relying on basic repeating UV tiling alone.

package/template/index.html

@@ -3,7 +3,9 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="theme-color" content="#e8edf3" />
+    <meta name="theme-color" content="#0f172a" />
+    <link rel="icon" href="%BASE_URL%favicon.ico" sizes="any" />
+    <link rel="icon" href="%BASE_URL%favicon.svg" type="image/svg+xml" />
     <title>Run3D</title>
   </head>
   <body>

package/template/package.json

@@ -3,9 +3,9 @@
   "private": true,
   "version": "0.0.0",
   "type": "module",
-  "packageManager": "pnpm@12.4.1",
+  "packageManager": "pnpm@12.8.1",
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.22.0"
   },
   "scripts": {
     "dev": "vite",
@@ -16,9 +16,9 @@
     "@floating-ui/react": "^0.27.20",
     "@gsap/react": "^2.1.2",
     "@headlessui/react": "^2.2.10",
-    "@react-three/drei": "^10.7.8",
-    "@react-three/fiber": "^9.7.0",
-    "@react-three/postprocessing": "^3.1.1",
+    "@react-three/drei": "^10.7.9",
+    "@react-three/fiber": "^9.8.1",
+    "@react-three/postprocessing": "^3.1.3",
     "@react-three/rapier": "^2.2.0",
     "@recast-navigation/three": "^0.43.1",
     "d3": "^7.9.0",
@@ -27,14 +27,16 @@
     "koota": "^0.6.6",
     "math": "0.1.0",
     "navcat": "^0.4.1",
-    "p5": "^2.3.3",
+    "p5": "^2.3.4",
     "postprocessing": "^6.39.5",
     "react": "19.2.8",
     "react-dom": "19.2.8",
-    "react-router": "^7.18.3",
+    "react-hotkeys-hook": "^5.3.3",
+    "react-router": "^8.4.0",
     "recast-navigation": "^0.43.1",
-    "three": "^0.186.0",
+    "three": "^0.186.1",
     "three-hex-tiling": "^0.1.5",
+    "tsl-hex-tiling": "^0.1.1",
     "zustand": "^5.0.15"
   },
   "devDependencies": {
@@ -42,6 +44,6 @@
     "@vitejs/plugin-react": "^6.1.1",
     "r3f-perf": "^7.2.3",
     "tailwindcss": "^4.3.3",
-    "vite": "^8.3.0"
+    "vite": "^8.3.1"
   }
 }