From 6bd456764ebc41036ce5a25e28dde3a0e990bd6c Mon Sep 17 00:00:00 2001
From: Daniel Stock <daniel.stock@tooloop.de>
Date: Fri, 2 Oct 2026 16:14:37 +0200
Subject: [PATCH] Add a README

---
 README.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/README.md b/README.md
index 1f311f4..4def07a 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,62 @@
 # Snappy-Carousel
 
+Snappy is yet another carousel library.
+Its goal is to be as lightweight and performant as possible.
+It does not implement every feature found in other carousel libraries. Instead, it relies on native CSS scroll snapping and adds as little on top as possible.
+
+Mouse-drag behavior closely follows native touch scrolling in the browser, including inertia and snapping to a slide.
+
+| File       |    Size |
+| ---------- | ------: |
+| snappy.js  | 6,17 kB |
+| snappy.css | 1,11 kB |
+
+
+## Usage
+
+### CSS only
+
+You can use Snappy without JavaScript. This gives you a simple CSS-only scroll container with snapping slides.
+
+```html
+<!-- include the stylesheet in <head> -->
+<link rel="stylesheet" href="dist/snappy.css">
+
+<!-- add this structure -->
+<div id="demo-carousel" class="snappy-carousel">
+    <div class="snappy-slide"></div>
+    <div class="snappy-slide"></div>
+    <div class="snappy-slide"></div>
+    ...
+</div>
+```
+
+Snappy is mostly unstyled, leaving the appearance up to you. For inspiration, see the [example](index.html).
+
+### Add JavaScript
+
+Including the JavaScript adds the following features:
+
+- Previous and next buttons
+- Pagination
+- Mouse dragging
+
+```html
+<script src="dist/snappy.js" defer></script>
+```
+
+
+## Development
+
+Install the development dependencies and build the minified JavaScript and CSS files into `dist`:
+
+```sh
+npm install
+npm run build
+```
+
+To rebuild the files whenever a source file changes, run:
+
+```sh
+npm run watch
+```
\ No newline at end of file