Contributing guidelines — GSAP + Three.js work

[0xTHAC0]

Hi team,

We've been exploring satus as a foundation for content-driven sites at our org and really like the architecture — clean App Router patterns, the Lenis integration, and the overall component structure.

We're interested in contributing back, specifically around GSAP and Three.js integration:

• Animation primitives or helpers that build on your existing Lenis/GSAP setup
• Three.js components or patterns for WebGL sections (backgrounds, transitions, interactive elements)
• Supporting demos or examples showcasing these integrations

Since there's no CONTRIBUTING.md yet, a few questions before we start:

1. Are you open to external contributions? We understand satus is a studio starter, so we want to gauge whether outside PRs are welcome or if this is primarily an internal tool.
2. Preferred contribution areas? Would you value docs, tests, demos, or new components most? We'd rather align with your priorities.
3. Any conventions we should follow? We noticed the PR template and the existing code style — anything else we should know about branch naming, commit format, or review expectations?

Happy to start small (docs, tests, or a focused demo) and build from there. Thanks for making this available under MIT — it's a solid foundation.

[clementroche]

Hey @0xTHAC0, glad you liked it, this starter is the result of years of expertise working in real production websites, mostly towards scroll driven experiences and fully editable content.

1. It's primarly an internal too but we're open to external contributions as long as they don't shift too much from the given state.
2. I'd say we're lacking visual examples (demos), as it's internally used we already know what it's capable of.
3. For conventions I'd push for using our Claude Code settings, as this is what we're using on daily basis.

That said i'd say let's start with some small PR from your side, this way it's easier to review. Then we can commit on bigger tasks.

Also i'm cusrious to see what's your org about?