Skip to content

feat: Update FAQ to reflect V Beta 2.1 #38

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
validcube wants to merge 4 commits into
base: master
Choose a base branch
from
Open

feat: Update FAQ to reflect V Beta 2.1 #38

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
2f885c4
docs: Update GNC, and widget issue
validcube Feb 22, 2026
0d05647
docs: Correct octicon tip styling
validcube Feb 22, 2026
1264823
Merge branch 'master' into vit-beta-2.1-milestone
validcube Feb 27, 2026
975053c
docs: Update docs
validcube Feb 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions downloads/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,8 @@

<link href="/assets/m3/colors.css" rel="stylesheet" />
<link href="/assets/m3/shapes.css" rel="stylesheet" />
<link href="/assets/common.css?newv6" rel="stylesheet" >
<link href="styles.css?newv5" rel="stylesheet" >
<link href="/assets/common.css?newv7" rel="stylesheet" >
<link href="styles.css?newv6" rel="stylesheet" >
Comment on lines +35 to +36
Copy link
Copy Markdown
Contributor

@SuperDragonXD SuperDragonXD Apr 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a need for us to do this in this location?

<script src="/assets/common.js?newv5" defer></script>
<script src="script.js?newv5_c12" defer></script>
</head>
Expand Down
26 changes: 18 additions & 8 deletions faq/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Welcome to the Lawnchair FAQ! This page provides answers to frequently asked questions about projects relating to Lawnchair, including Lawnicons.

Last updated: July 14, 2025
Last updated: March 1, 2025
Comment thread
validcube marked this conversation as resolved.

## Getting started

Expand Down Expand Up @@ -44,7 +44,7 @@ Lawnicons is an icon pack that aims to recreate themed icons for many launchers.

### What's the latest version of Lawnchair?

The latest official release is [Lawnchair 15 Beta 1](https://github.com/LawnchairLauncher/lawnchair/releases/tag/v15.0.0-beta1). We are also developing newer versions of Lawnchair 15 in our nightly builds.
The latest official release is [Lawnchair 15 Beta 2.1](https://github.com/LawnchairLauncher/lawnchair/releases/tag/v15.0.0-beta2.1). We are also developing newer versions of Lawnchair 15 in our nightly builds.

### What happened to Lawnchair Legacy?

Expand Down Expand Up @@ -113,7 +113,10 @@ Due to security reasons, Android 13+ disallows notifications access and accessib

See [the support page on Google](https://support.google.com/android/answer/12623953#allowrestrictedsettings) for more information.

### Adding widgets does nothing or cause Lawnchair to crash.
### Adding widgets does nothing or cause Lawnchair to crash

> [!TIP]
> **This issue have been fix in Lawnchair 15 Beta 2.1 and newer!**
Comment thread
validcube marked this conversation as resolved.

This is a relatively common issue, especially when the widget has a set-up screen. This issue has been fixed on Android 14 and above, but for older Android versions (or if you are still having issues), follow these steps:

Expand All @@ -129,17 +132,24 @@ Disable force-dark on your phone's settings.

### I'm having issues with gesture navigation

> [!TIP]
> **This issue have been fix in Lawnchair 15 Beta 2.1 and newer!**
>
> If you are still having issue you might want to consider disabling GestureNavContract feature in favor of default opening/closing animation in
> *Home settings > Three-dots at the top right > Experimental features > GestureNavContract API*

Comment thread
validcube marked this conversation as resolved.
Smooth gesture navigation is a priority for a great launcher experience. However, its behavior with third-party launchers like Lawnchair can vary significantly based on your phone's manufacturer (OEM), their Android customization, and your Android version.

Android is designed so the original system launcher often has special privileges for handling gesture animations (like swiping home or accessing the Recents screen) most fluidly. When you switch to a third-party launcher, these integrations might not be as seamless.

1. **For rooted users (Best Experience): QuickSwitch**
* If your device is rooted, using the **[QuickSwitch Magisk module](https://github.com/skittles9823/QuickSwitch)** is highly recommended.
* QuickSwitch allows Lawnchair to integrate deeply as the system's QuickStep (Recents) provider, resulting in the smoothest animations and access to more Recents features.
* See our [QuickSwitch FAQ section](#what-is-quickswitch-for-rooted-users-only) for more details.
- If your device is rooted, using the **[QuickSwitch Magisk module](https://github.com/skittles9823/QuickSwitch)** is highly recommended.
- QuickSwitch allows Lawnchair to integrate deeply as the system's QuickStep (Recents) provider, resulting in the smoothest animations and access to more Recents features.
- See our [QuickSwitch FAQ section](#what-is-quickswitch-for-rooted-users-only) for more details.
2. **For non-rooted users: GestureNavContract API**
* Lawnchair implements Google's **GestureNavContract API** (Android 11+) for non-rooted devices. This API helps improve animation smoothness for actions like app open/close and returning home.
* **Note:** The effectiveness of GestureNavContract depends heavily on how well your device manufacturer has implemented it. Devices with AOSP-like Android versions (such as Google Pixel, Nothing Phone, Fairphone, or custom ROMs based on AOSP) tend to have better results. Devices with heavily customized Android skins (e.g., MIUI, ColorOS, OneUI) may still exhibit more issues.
- If you are using Lawnchair 15 Beta 2.1, disable the GestureNavContract API to revert back to default animation in *Home settings > Three-dots at the top right > Experimental features > GestureNavContract API*.
Comment thread
validcube marked this conversation as resolved.
- Lawnchair implements Google's **GestureNavContract API** (Android 11+) for non-rooted devices. This API helps improve animation smoothness for actions like app open/close and returning home.
- **Note:** The effectiveness of GestureNavContract depends heavily on how well your device manufacturer has implemented it. Devices with AOSP-like Android versions (such as Google Pixel, Nothing Phone, Fairphone, or custom ROMs based on AOSP) tend to have better results. Devices with heavily customized Android skins (e.g., MIUI, ColorOS, OneUI) may still exhibit more issues.

#### Common gesture-related issues you might encounter

Expand Down
18 changes: 14 additions & 4 deletions faq/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
<link href="/assets/m3/shapes.css" rel="stylesheet" />
<link href="/assets/common.css?newv6" rel="stylesheet" />
<link href="/assets/document.css?newv5" rel="stylesheet" >
<link href="styles.css?newv5" rel="stylesheet" />
<link href="styles.css?newv6" rel="stylesheet" />
<script src="/assets/common.js?newv5" defer></script>
<script src="script.js?newv5" defer></script>

Expand Down Expand Up @@ -99,7 +99,7 @@
<p><a href="/support">Support</a> > <strong>FAQ</strong></p>
<h1>Lawnchair FAQ</h1>
<p>Welcome to the Lawnchair FAQ! This page provides answers to frequently asked questions about projects relating to Lawnchair, including Lawnicons.</p>
<p>Last updated: May 26, 2025</p>
<p>Last updated: March 1, 2025</p>
<div id="toc" class="collapsed"></div>
<h2 id="getting-started">Getting started</h2>
<h3 id="what-is-lawnchair">What is Lawnchair?</h3>
Expand Down Expand Up @@ -133,7 +133,7 @@ <h3 id="whats-the-difference-between-the-play-store-telegramdiscord-and-github-r
<li>Play Store: has Lawnicons and Lawnchair (under a different package name). Also has the unsupported Lawnchair Legacy version. Note that these apps install as a separate version from the GitHub releases.</li>
</ul>
<h3 id="whats-the-latest-version-of-lawnchair">What&#39;s the latest version of Lawnchair?</h3>
<p>The latest official release is <a href="https://github.com/LawnchairLauncher/lawnchair/releases/tag/v15.0.0-beta1">Lawnchair 15 Beta 1</a>. We are also developing newer versions of Lawnchair 15 in our nightly builds.</p>
<p>The latest official release is <a href="https://github.com/LawnchairLauncher/lawnchair/releases/tag/v15.0.0-beta2.1">Lawnchair 15 Beta 2.1</a>. We are also developing newer versions of Lawnchair 15 in our nightly builds.</p>
<h3 id="what-happened-to-lawnchair-legacy">What happened to Lawnchair Legacy?</h3>
<p><a href="https://play.google.com/store/apps/details?id=ch.deletescape.lawnchair.plah">Lawnchair Legacy</a> (previously known as Lawnchair v2) is an older stable release of Lawnchair that we no longer support. Due to limited resources, developers are focused on the latest versions of Lawnchair.</p>
<h3 id="is-lawnchair-free-is-it-open-source">Is Lawnchair free? Is it open source?</h3>
Expand Down Expand Up @@ -179,7 +179,11 @@ <h3 id="restricted-settings-on-android-13">Restricted settings on Android 13+</h
<li>Go back to the setting that you want to turn on. You should be able to turn these on.</li>
</ol>
<p>See <a href="https://support.google.com/android/answer/12623953#allowrestrictedsettings">the support page on Google</a> for more information.</p>
<h3 id="adding-widgets-does-nothing-or-cause-lawnchair-to-crash">Adding widgets does nothing or cause Lawnchair to crash.</h3>
<h3 id="adding-widgets-does-nothing-or-cause-lawnchair-to-crash">Adding widgets does nothing or cause Lawnchair to crash</h3>
<div class="markdown-alert markdown-alert-tip">
<p class="markdown-alert-title"><svg class="octicon octicon-report mr-2" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.751.751 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z"></path></svg>Tip</p>
<p><strong>This issue have been fix in Lawnchair 15 Beta 2.1 and newer!</strong></p></p>
</div>
<p>This is a relatively common issue, especially when the widget has a set-up screen. This issue has been fixed on Android 14 and above, but for older Android versions (or if you are still having issues), follow these steps:</p>
<ol>
<li>Change the default launcher to your system launcher.</li>
Expand All @@ -190,6 +194,11 @@ <h3 id="adding-widgets-does-nothing-or-cause-lawnchair-to-crash">Adding widgets
<h3 id="some-parts-of-the-ui-look-weird-ie-themed-icons-on-dark-mode">Some parts of the UI look weird (i.e. themed icons) on dark mode</h3>
<p>Disable force-dark on your phone&#39;s settings.</p>
<h3 id="im-having-issues-with-gesture-navigation">I&#39;m having issues with gesture navigation</h3>
<div class="markdown-alert markdown-alert-tip">
<p class="markdown-alert-title"><svg class="octicon octicon-report mr-2" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.751.751 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z"></path></svg>Tip</p>
<p><strong>This issue have been fix in Lawnchair 15 Beta 2.1 and newer!</strong></p></p>
<p>If you are still having issue you might want to consider disabling GestureNavContract feature in favor of default opening/closing animation in <em>Home settings &gt; Three-dots at the top right &gt; Experimental features &gt; GestureNavContract API</em></p>
</div>
<p>Smooth gesture navigation is a priority for a great launcher experience. However, its behavior with third-party launchers like Lawnchair can vary significantly based on your phone&#39;s manufacturer (OEM), their Android customization, and your Android version.</p>
<p>Android is designed so the original system launcher often has special privileges for handling gesture animations (like swiping home or accessing the Recents screen) most fluidly. When you switch to a third-party launcher, these integrations might not be as seamless.</p>
<ol>
Expand All @@ -200,6 +209,7 @@ <h3 id="im-having-issues-with-gesture-navigation">I&#39;m having issues with ges
</ul>
</li>
<li><strong>For non-rooted users: GestureNavContract API</strong><ul>
<li>If you are using Lawnchair 15 Beta 2.1, disable the GestureNavContract API to revert back to default animation in <em>Home settings &gt; Three-dots at the top right &gt; Experimental features &gt; GestureNavContract API</em>.</li>
<li>Lawnchair implements Google&#39;s <strong>GestureNavContract API</strong> (Android 11+) for non-rooted devices. This API helps improve animation smoothness for actions like app open/close and returning home.</li>
<li><strong>Note:</strong> The effectiveness of GestureNavContract depends heavily on how well your device manufacturer has implemented it. Devices with AOSP-like Android versions (such as Google Pixel, Nothing Phone, Fairphone, or custom ROMs based on AOSP) tend to have better results. Devices with heavily customized Android skins (e.g., MIUI, ColorOS, OneUI) may still exhibit more issues.</li>
</ul>
Expand Down
5 changes: 5 additions & 0 deletions faq/styles.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,11 @@ code {
color: var(--on-tertiary-container);
}

.markdown-alert.markdown-alert-tip {
border-left: 8px solid var(--lawnchair-green-color-container);
color: var(--on-tertiary-container);
}

Comment on lines 116 to +121
Copy link
Copy Markdown
Contributor

@SuperDragonXD SuperDragonXD Apr 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With my suggestions, we won't need markdown notices anymore.

.markdown-alert .markdown-alert-title {
display: flex;
align-items: center;
Expand Down
4 changes: 2 additions & 2 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@

<link href="/assets/m3/colors.css" rel="stylesheet" />
<link href="/assets/m3/shapes.css" rel="stylesheet" />
<link href="/assets/common.css?newv62" rel="stylesheet" >
<link href="styles.css?newv52" rel="stylesheet" >
<link href="/assets/common.css?newv72" rel="stylesheet" >
<link href="styles.css?newv62" rel="stylesheet" >
<script src="/assets/common.js?newv5" defer></script>
<script src="script.js?newv5_c12" defer></script>

Expand Down