diff --git a/Fully-functional-sway-desktop-with-GNOME-integration-under-Debian-Ubuntu.md b/Fully-functional-sway-desktop-with-GNOME-integration-under-Debian-Ubuntu.md
new file mode 100644
index 0000000..f1071ea
--- /dev/null
+++ b/Fully-functional-sway-desktop-with-GNOME-integration-under-Debian-Ubuntu.md
@@ -0,0 +1,21 @@
+## Introduction
+
+**Note**: These instructions are community maintained and are not supported by sway.
+
+This page is intended to help you set up a fully-functional sway desktop environment integrated with GNOME under Debian 10/Ubuntu. Features that will be covered:
+
+- GNOME integration, so that you can run GNOME apps and use GNOME settings to manage the network.
+- Working notifications with `mako`.
+- Nice application launcher and exit menu using `fzf` and `kitty`
+- Taking of screenshots, optionally selecting a region, using `grim` and `slurp`
+- Manual and automatic screen locking using `swayidle` and `swaylock`
+- Volume control with multimedia keys
+- Laptop screen brightness adjustment using `brightnessctl` and bound to keyboard keys
+- Nice status bar using `Waybar`
+
+These instruction were tested under Debian 10 (Buster), but should also work under Ubuntu with minimal modifications.
+
+## Install sway
+
+To do a basic install of sway under Debian 10, follow the instruction on the page [Debian-10-(Buster)-Installation](./Debian-10-(Buster)-Installation). They should also work with minimal modifications under Ubuntu.
+