utm-scroll-scene 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,74 @@
1
+ # utm-scroll-scene
2
+
3
+ Zipline-style scroll-driven drone delivery landing page component for React.
4
+
5
+ ## Install as dependency
6
+
7
+ ```bash
8
+ npm install utm-scroll-scene
9
+ ```
10
+
11
+ Install peer dependencies if not already present:
12
+
13
+ ```bash
14
+ npm install react react-dom gsap motion three
15
+ ```
16
+
17
+ ## Usage
18
+
19
+ ```tsx
20
+ import { ScrollScene } from "utm-scroll-scene";
21
+ import "utm-scroll-scene/styles.css";
22
+
23
+ export default function Page() {
24
+ return (
25
+ <>
26
+ <div className="zipline-spacer" style={{ height: "300vh" }} />
27
+ <ScrollScene />
28
+ </>
29
+ );
30
+ }
31
+ ```
32
+
33
+ **Assets:** Copy the `public/3d-models` folder from this package into your app's public directory so URLs like `/3d-models/assets/drone/scene.gltf` resolve.
34
+
35
+ ## Development (this repo)
36
+
37
+ This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
38
+
39
+ Build the library: `npm run build:lib`
40
+
41
+ ## Getting Started
42
+
43
+ First, run the development server:
44
+
45
+ ```bash
46
+ npm run dev
47
+ # or
48
+ yarn dev
49
+ # or
50
+ pnpm dev
51
+ # or
52
+ bun dev
53
+ ```
54
+
55
+ Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
56
+
57
+ You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
58
+
59
+ This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
60
+
61
+ ## Learn More
62
+
63
+ To learn more about Next.js, take a look at the following resources:
64
+
65
+ - [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
66
+ - [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
67
+
68
+ You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
69
+
70
+ ## Deploy on Vercel
71
+
72
+ The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
73
+
74
+ Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.