sylva README

The project's README from github.com/MengTo/sylva. As one markdown file: README.md.

Sylva

Sylva is an interactive Three.js landscape study: a procedural, moss-covered root grows through an editorial conservation hero and reacts to the pointer as if it were alive.

View the live experience

Sylva's living moss landscape and editorial interface

What is inside

How it is made

The complete page lives in index.html. It uses a vendored Three.js r149 build to create the root, moss, undergrowth, flowers, moths, pointer spray, light, and camera movement at runtime. The same seeded noise grows the same landscape on every load; no model file or pre-rendered moss plate is downloaded.

The interface is plain HTML and CSS around that scene. Pointer parallax, the navigation dock, the card reveals, and the WebGL renderer share one animation loop. The two liquid-metal controls remain isolated in sandboxed iframes so each control can own its WebGL2 state without leaking into the page.

Everything required at runtime is included in this repository. The page makes no external network request after it loads.

Run locally

Serve the repository root over HTTP:

python3 -m http.server 4173 --bind 127.0.0.1

Then visit http://127.0.0.1:4173/.

There is no install or build step. A browser with WebGL2 support is recommended; the page retains its layout and core content if the main Three.js scene cannot start.

Project structure

sylva/
├── index.html                  # Complete experience
├── sylva-assets/
│   ├── three.min.js             # Vendored Three.js r149 runtime
│   ├── lexend-latin.woff2       # Local Lexend variable font
│   ├── liquid-metal-explore.html
│   ├── liquid-metal-play.html
│   └── card-*.webp               # Field-note imagery
├── assets/                     # README preview
├── licenses/                   # Third-party license texts
└── README.md

With me

Design and attribution

The layout began as an independent study of an editorial conservation composition by Daniel Snows. Sylva preserves the broad compositional idea while replacing its foreground artwork with original procedural geometry, shaders, motion, and interactions. It is not affiliated with or endorsed by the original designer.

The local project notes record Higgsfield image generation and compositing for the supporting imagery. Three.js r149 is distributed under the MIT License, and Lexend is distributed under the SIL Open Font License 1.1; their license texts are included in licenses/.

No license is granted for reuse or redistribution of the Sylva code, design, or artwork. The bundled third-party components remain under their respective licenses.

sylva (MengTo/sylva)

Searching Database…

348 ·GitHub
Что это?Sylva — это интерактивный этюд пейзажа на Three.js: процедурный, покрытый мхом корень прорастает сквозь журнальную природоохранную сцену и реагирует на указатель, как живой.
Это переиспользуемая библиотека или просто отдельная страница?Это отдельная самодостаточная веб-страница, а не библиотека для импорта — всё действо живёт в одном index.html, построенном на vendored-сборке Three.js r149.
Как запустить его локально?Просто раздайте корень репозитория любым HTTP-сервером и откройте страницу — нет ни шага установки, ни конвейера сборки.
Нужно ли что-то, кроме браузера?Только браузер с поддержкой WebGL2; если сцена Three.js не сможет запуститься, страница всё равно сохранит вёрстку и основной контент.
Мшистый пейзаж случайно меняется при каждом посещении?Нет — он детерминирован: один и тот же шум с фиксированным зерном при каждой загрузке выращивает идентичные корень, мох и подлесок, безо всяких скачиваемых вещей вроде заранее отрисованной плиты мха или 3D-модели.
Обращается ли страница к серверу после загрузки?Нет — вся геометрия, шум и изображения, нужные во время работы, лежат в репозитории, и после загрузки страница не делает внешних сетевых запросов.
Можно ли переиспользовать код, дизайн или графику?Нет — собственный код, дизайн и графика Sylva не лицензированы для переиспользования или распространения, хотя входящие в комплект Three.js (MIT) и шрифт Lexend (OFL) сохраняют свои открытые лицензии.
Что происходит со мхом, когда я двигаю указатель?Мох расступается вокруг курсора и выпускает короткий след пыльцы, пока указатель движется по пейзажу, — всё анимировано в том же цикле, что и остальная сцена.
Кнопки Explore и Play — часть основной 3D-сцены?Нет, каждая кнопка из жидкого металла работает в собственном изолированном WebGL2-iframe, чтобы её состояние шейдеров не могло утечь в рендерер основной страницы.
Сколько мха он реально отрисовывает?До 250 000 инстансированных травинок мха на десктопе, построенных из геометрии протяжённых трубок с рекурсивными отростками, папоротниками, цветами и частицами.
Откуда пришла идея исходной композиции?Вёрстка начиналась как независимое изучение журнальной природоохранной композиции дизайнера Daniel Snows; Sylva заменяет передний план оригинальной процедурной геометрией и движением и не связана с исходным дизайнером.
Creator
MengTo
Size
1.8 MB
Stars
348
Updated
CommitAug 18
Age
1mo
Commits · 90 Days