stellar-kit

A modular frontend utility kit for custom websites. Built for performance, extensibility, and clean developer ergonomics — with support for smooth scrolling, events, tick updates, mouse tracking, and layout helpers.

✨ Features

• RAF-based update loop (Raf)
• Virtual scroll support (Scroll)
• Viewport-based resize tracking (Resize)
• Centralized event system (Emitter)
• Mouse tracking (Mouse)
• Utility helpers (DOM selection, bounds, clamping, etc.)
• Designed for use with Astro, GSAP, Three.js, and modular frontend setups

📦 Installation

npm install @linear_non/stellar-kit

🧱 Folder Structure

stellar-kit/
├── classes/      # Core logic: Manager, Component.
├── events/       # Emitter system: Raf, Resize, Scroll, Mouse, etc.
├── utils/        # Utilities: bounds, clamp, selectors, sniffer, etc.
├── plugins/      # Helpers Grid, Observer, SplitText, etc.
├── kitStore.js   # Central store shared across all modules
└── index.js      # Entry point for setupKit and kitStore access

🧪 Local Development

npm install
npm run dev

The dev/ folder provides a Vite playground to test modules like Smooth, Scrollbar, and events. You can import any part of the kit and prototype in isolation.

🛠️ Usage Example

// main.js or index.js of your project
import { kitStore, setupKit } from "stellar-kit"

setupKit() // Initializes Resize, Raf, Scroll, Mouse, etc.

// Access anywhere
kitStore.scroll
kitStore.raf
kitStore.mouse

You can also import from specific paths:

import { bounds, clamp, qs } from "stellar-kit/utils"
import { Manager } from "stellar-kit/classes"
import { Raf } from "stellar-kit/events"

Made with ❤️ by Non-Linear Studio