# FarazzShaikh/THREE-CustomShaderMaterial

🧩 Extend Three.js standard materials with your own shaders!

Repository: https://github.com/FarazzShaikh/THREE-CustomShaderMaterial
Canonical: https://ross.abutalabs.com/products/three-customshadermaterial
Homepage: https://farazzshaikh.github.io/THREE-CustomShaderMaterial/
Language: TypeScript
License: MIT
License Family: permissive
Topics: shaders, webgl, threejs, custom, 3d
Last push: 2025-10-12T08:26:41+00:00

## Health v2 (maintenance only)
Score: 44/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 46, release rhythm 8, longevity 100
- inputs: {"age_days": 2207, "days_push": 325, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1328, forks 78 (observed 2026-08-28T04:04:23.645010+00:00)

## What it is
A TypeScript library that lets you extend Three.js standard materials with custom vertex and fragment shaders. It supports both vanilla Three.js and React (react-three-fiber) workflows.

## Use cases
- add custom glsl shaders to three.js materials
- extend meshphysicalmaterial with custom vertex shader
- write custom fragment shaders in react-three-fiber
- create water waves or caustics effects in webgl
- inject uniforms into three.js standard materials
- combine custom shaders with three.js lighting and shadows

## When to choose
- you want custom shader effects while keeping three.js built-in material features like lighting and shadows
- you work with react-three-fiber and need custom materials
- you want to avoid rewriting three.js shader chunks from scratch

## When to avoid
- you need fully custom raw shader materials with no three.js base material
- you are not using three.js or webgl
- you need post-processing effects rather than material-level shaders

## Facets
- artifact type: library
- maturity: active
- function: graphics, ui-components, animation
- domain: graphics, web-development, frontend
- platform: browser
- tags: threejs, webgl, shaders, glsl, react-three-fiber, 3d-graphics, game-development, web-server, javascript, nodejs

## Member repositories
- FarazzShaikh/THREE-CustomShaderMaterial (main) score 44

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:23.645010+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:45:47.858347+00:00, confidence not recorded.
  - readme: https://github.com/FarazzShaikh/THREE-CustomShaderMaterial (fetched 2026-08-28T04:04:23.645010+00:00, sha 3819db8dacdf)
  - homepage: https://farazzshaikh.github.io/THREE-CustomShaderMaterial/ (fetched 2026-08-29T12:05:10.033501+00:00, sha 8eb935b9bad4)
- Data as of 2026-08-30T08:39:29.467469+00:00.