explaingit

ramonszo/zuck.js

Analysis updated 2026-07-03

3,728TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

Zuck.js is a JavaScript library that adds Instagram-style story carousels, timed sequences of photos and videos, to any website, with four built-in themes, a dynamic API, and React support.

Mindmap

mindmap
  root((Zuck.js))
    Features
      Stories carousel
      Photos and video
      4 built-in themes
    Setup
      npm or CDN
      React support
      Firebase data source
    Customization
      Custom CSS themes
      Dynamic story API
    Limitations
      Mobile muted video
      User unmute prompt
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add an Instagram-style stories carousel to a marketing landing page to showcase product features in a tap-through format.

USE CASE 2

Display user-generated photo or video stories on a social or community web app without building the player from scratch.

USE CASE 3

Pull story content dynamically from a Firebase database and render it using Zuck.js's built-in data source support.

USE CASE 4

Integrate timed story slides into a React app using the library's dedicated React component wrapper.

What is it built with?

TypeScriptJavaScriptReactFirebaseCSS

How does it compare?

ramonszo/zuck.jspimzino/claude-code-spec-workflowshopify/hydrogen-v1
Stars3,7283,7273,731
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min
Use freely for any purpose, including commercial use, with no conditions beyond keeping the copyright notice.

In plain English

Zuck.js is a JavaScript library that adds a "stories" feature to any website. Stories are the format popularized by Snapchat and adopted widely by Instagram, WhatsApp, and Facebook: a sequence of photos or short videos that play one after another and disappear after a set time. This library lets developers add that same format to their own sites without building it from scratch. The library reads story content from any data source you point it at, such as a JSON file or a Firebase database, and handles all the display logic itself. It comes with four visual themes out of the box that mimic the look of popular apps: Snapgram, FaceSnap, Snapssenger, and VemDeZAP. You can also write custom themes using CSS. Setup involves adding the library to a page (available via npm or a CDN script tag), creating a container element in the HTML, and initializing the library with a reference to that element. After that, a small API lets you add, update, or remove stories and individual story items dynamically. There is also React support for teams using that framework. The README notes one important limitation on mobile browsers: video inside stories cannot play with sound automatically due to browser restrictions on autoplay audio. The library works around this by muting video that plays on its own, then showing a prompt so the user can tap to turn sound on. The project is released under the MIT license and is actively maintained. It is a drop-in addition for any web project that wants to offer an Instagram-style stories experience to its users.

Copy-paste prompts

Prompt 1
Using Zuck.js, show me how to add an Instagram-style stories carousel to a plain HTML page, include the CDN script tag, container div, and initialization code with two sample story items.
Prompt 2
I'm building a React app and want to add stories using Zuck.js. Show me the React integration code with at least two sample story items and the correct import setup.
Prompt 3
How do I load Zuck.js story content from a Firebase Realtime Database? Show the expected data structure and the initialization config that points to it.
Prompt 4
I want to use the VemDeZAP theme in Zuck.js. Show me the theme option and any custom CSS tweaks I can use to match my site's brand colors.
Prompt 5
Zuck.js mutes video on mobile because browsers block autoplay audio. What workaround does the library use and how can I customize the unmute prompt shown to users?

Frequently asked questions

What is zuck.js?

Zuck.js is a JavaScript library that adds Instagram-style story carousels, timed sequences of photos and videos, to any website, with four built-in themes, a dynamic API, and React support.

What language is zuck.js written in?

Mainly TypeScript. The stack also includes TypeScript, JavaScript, React.

What license does zuck.js use?

Use freely for any purpose, including commercial use, with no conditions beyond keeping the copyright notice.

How hard is zuck.js to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is zuck.js for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ramonszo on gitmyhub

Verify against the repo before relying on details.