PHPackages                             olleksi/flarum-swipe - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. olleksi/flarum-swipe

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

olleksi/flarum-swipe
====================

Add swipe gestures to Flarum for better mobile navigation

v0.0.4(5mo ago)0152MITJavaScript

Since Nov 11Pushed 5mo agoCompare

[ Source](https://github.com/olleksi/flarum-swipe)[ Packagist](https://packagist.org/packages/olleksi/flarum-swipe)[ RSS](/packages/olleksi-flarum-swipe/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (5)Used By (0)

Flarum Swipe Gestures
=====================

[](#flarum-swipe-gestures)

англійської я не знаю, цей опис робив ші, тож якщо там якась дурня написана - вибачайте. якщо коротко то це розширення яке дозволяє свайпом повертатись на попередню сторінку або відкрити меню.

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)

A [Flarum](http://flarum.org) extension that adds intuitive swipe gestures for better mobile and desktop navigation.

Features
--------

[](#features)

### 🔄 Swipe to Close Dropdowns

[](#-swipe-to-close-dropdowns)

- Swipe down on any dropdown menu to close it
- Works on both mobile and desktop
- Smooth animations with visual feedback
- Adaptive corner radius animation

### ↔️ Navigation Swipes

[](#️-navigation-swipes)

- **Swipe right**: Go back to the previous page
- **Swipe left** (on homepage): Navigate to "All Discussions"
- Page transition animations with 3D effects
- Smart detection to avoid conflicts with UI elements

### 🎨 Visual Indicators

[](#-visual-indicators)

- Swipe indicator bar at the top of dropdowns
- Adaptive opacity during drag
- Color support for light and dark themes
- Accessibility-friendly design

Installation
------------

[](#installation)

1. Download this extension
2. Place it in your Flarum's `extensions` folder as `olleksi-swipe`
3. Enable it in the admin panel

**Or via Composer:**

```
composer require olleksi/flarum-swipe:"*"
php flarum cache:clear
```

File Structure
--------------

[](#file-structure)

```
olleksi-swipe/
├── composer.json
├── extend.php
├── LICENSE
├── README.md
└── resources/
    ├── swipe.js      # JavaScript logic
    └── swipe.css     # Styles

```

How It Works
------------

[](#how-it-works)

This extension is **super simple** - no compilation, no build process:

- Pure JavaScript (no frameworks needed)
- CSS file ready to use
- Just drop in and enable!

The extension automatically:

- Detects mobile vs desktop environments
- Adapts to screen sizes
- Respects user preferences (reduced motion, etc.)
- Avoids conflicts with scrollable areas

Customization
-------------

[](#customization)

### Adjusting Swipe Thresholds

[](#adjusting-swipe-thresholds)

Edit `resources/swipe.js` and change these values:

```
const swipeRightThreshold = 200;  // Distance for back navigation
const swipeLeftThreshold = -140;  // Distance for forward navigation
const swipeIgnoreThreshold = 90;  // Minimum movement to register
```

### Styling

[](#styling)

Override CSS in your theme:

```
.swipe-indicator {
    background-color: #your-color;
    height: 5px;
    width: 50px;
}
```

Browser Compatibility
---------------------

[](#browser-compatibility)

- ✅ Chrome/Edge 90+
- ✅ Firefox 88+
- ✅ Safari 14+
- ✅ Mobile browsers (iOS Safari, Chrome Mobile)

Troubleshooting
---------------

[](#troubleshooting)

### Swipes not working

[](#swipes-not-working)

1. Make sure JavaScript is enabled
2. Check browser console for errors
3. Clear Flarum cache: `php flarum cache:clear`
4. Verify the extension is enabled in admin panel

### Conflicts with other extensions

[](#conflicts-with-other-extensions)

- Check for overlapping gesture zones
- Try disabling other extensions temporarily
- Check browser console for JavaScript errors

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance70

Regular maintenance activity

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

4

Last Release

177d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ff418feef785040d33a5f24174ad0bef2d68dc7ef90957c3a3fcff4af358aa51?d=identicon)[olleksi](/maintainers/olleksi)

---

Top Contributors

[![olleksi](https://avatars.githubusercontent.com/u/241199108?v=4)](https://github.com/olleksi "olleksi (19 commits)")

---

Tags

mobileextensiongesturesflarumswipe

### Embed Badge

![Health badge](/badges/olleksi-flarum-swipe/health.svg)

```
[![Health](https://phpackages.com/badges/olleksi-flarum-swipe/health.svg)](https://phpackages.com/packages/olleksi-flarum-swipe)
```

###  Alternatives

[fof/sitemap

Generate a sitemap

1988.7k2](/packages/fof-sitemap)[fof/mason

Add custom fields to discussions

206.0k](/packages/fof-mason)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)