https://github.com/ceriousdevtech/cerious-scroll
High-performance virtual scrolling library with O(1) memory usage. Handles 100M+ elements at 60+ FPS with native variable heights, framework-agnostic design, and patent-pending positioning algorithm. Perfect for data grids, chat apps, log viewers, and financial dashboards.
https://github.com/ceriousdevtech/cerious-scroll
Last synced: 8 days ago
JSON representation
High-performance virtual scrolling library with O(1) memory usage. Handles 100M+ elements at 60+ FPS with native variable heights, framework-agnostic design, and patent-pending positioning algorithm. Perfect for data grids, chat apps, log viewers, and financial dashboards.
- Host: GitHub
- URL: https://github.com/ceriousdevtech/cerious-scroll
- Owner: ceriousdevtech
- License: other
- Created: 2026-01-29T02:30:24.000Z (16 days ago)
- Default Branch: main
- Last Pushed: 2026-01-29T17:34:27.000Z (16 days ago)
- Last Synced: 2026-01-29T19:17:35.304Z (15 days ago)
- Language: TypeScript
- Size: 231 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- fucking-awesome-angular - cerious-scroll - High-performance virtual scrolling for web applications. (Third Party Components / Scroll)
- awesome-angular - cerious-scroll - High-performance virtual scrolling for web applications. (Third Party Components / Scroll)
README
# Cerious Scroll™
[](LICENSE)
[](https://www.npmjs.com/package/@ceriousdevtech/cerious-scroll)
[](LICENSE)
**High-Performance Virtual Scrolling for Web Applications**
Cerious Scroll™ is an enterprise-grade virtual scrolling engine that enables smooth scrolling through **millions to hundreds of millions of elements** at a consistent **60 FPS+**, while maintaining **O(1) constant memory usage**.
It is designed for data grids, chat applications, log viewers, financial dashboards, analytics platforms, and any application that must efficiently render massive datasets without performance degradation.
🌐 **[View Live Demos](https://ceriousdevtech.github.io/cerious-scroll/)** | 📚 **[Read Documentation](https://ceriousdevtech.github.io/cerious-scroll/docs/IMPLEMENTATION_GUIDE.html)**
---
## 🚀 Key Features
- **True O(1) Memory Usage**
Constant memory regardless of dataset size (tested with 100M+ elements)
- **Consistent 60 FPS+ Performance**
Sub-millisecond scroll calculations under real-world load
- **Native Variable Height Support**
No pre-calculation required — automatic, on-demand measurement
- **Framework Agnostic**
Works with Vanilla JS, Angular, React, Vue, or any framework
- **Native Scrollbar Integration**
Familiar UX with accurate bidirectional synchronization
- **Element-Based Positioning Algorithm**
Eliminates fragile pixel-math approaches
- **No GPU Transforms**
Pure DOM manipulation — no `translate3d` hacks
- **TypeScript Support**
Full type definitions included
---
## 📦 Installation
### npm
```bash
npm install @ceriousdevtech/cerious-scroll
```
### From Source
```bash
# Clone the repository
git clone https://github.com/ceriousdevtech/cerious-scroll.git
cd cerious-scroll
# Install dependencies and build
npm install
npm run build
# Use the built files from dist/
```
### Direct Download
Download the latest release from [GitHub Releases](https://github.com/ceriousdevtech/cerious-scroll/releases) and include:
```html
```
Or via CDN:
```html
```
---
## 🎯 Quick Start
```javascript
import { CeriousScroll } from '@ceriousdevtech/cerious-scroll';
const data = Array.from({ length: 10000 }, (_, i) => ({
id: i,
content: `Item ${i}`
}));
const container = document.getElementById('scroll-container');
const scroller = new CeriousScroll(
container,
data.length,
40
);
container.addEventListener('cerious-viewport-change', () => {
scroller.renderViewport(
container.clientHeight,
container,
(index, element) => {
element.innerHTML = `
${data[index].content}`;
return element.offsetHeight;
}
);
});
container.dispatchEvent(new CustomEvent('cerious-viewport-change'));
```
---
## 📄 License
Cerious Scroll™ is **dual-licensed** by **Cerious DevTech LLC**.
### Open-Source License
- **MIT License** (see LICENSE or LICENSE-MIT)
### Commercial License
Available for organizations that prefer a separately executed commercial agreement
(for example: explicit patent rights, priority support, or custom terms).
See LICENSE-COMMERCIAL for details.
📧 **info@ceriousdevtech.com**
---
## 🔒 Patent Status
**Patent Pending**
U.S. Provisional Patent Application filed by **Cerious DevTech LLC**, October 2025.
---
## 🤝 Contributing
By submitting a pull request, you agree to the **Contributor License Agreement (CLA)**.
---
## 📜 Copyright
Copyright © 2024–2026
**Cerious DevTech LLC**
All rights reserved.