From 5a735bc049a5681035502ffafaaf1da502e10bbb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Kuna?=
 <1282324+codecalm@users.noreply.github.com>
Date: Mon, 21 Sep 2026 10:22:45 +0200
Subject: [PATCH] Document that `tabler.js` already includes Bootstrap (#3103)

---
 .changeset/docs-single-bootstrap-note.md         |  5 +++++
 docs/content/ui/getting-started/installation.mdx | 16 ++++++++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 .changeset/docs-single-bootstrap-note.md

diff --git a/.changeset/docs-single-bootstrap-note.md b/.changeset/docs-single-bootstrap-note.md
new file mode 100644
index 000000000..1ef1d996a
--- /dev/null
+++ b/.changeset/docs-single-bootstrap-note.md
@@ -0,0 +1,5 @@
+---
+"@tabler/docs": patch
+---
+
+Added a note to the installation docs that `tabler.js` already includes Bootstrap and must not be loaded next to it.
diff --git a/docs/content/ui/getting-started/installation.mdx b/docs/content/ui/getting-started/installation.mdx
index f69199fda..7a6fe1fa7 100644
--- a/docs/content/ui/getting-started/installation.mdx
+++ b/docs/content/ui/getting-started/installation.mdx
@@ -72,4 +72,20 @@ Save the file and open it in your browser. You should see your first page styled
 
 </Steps>
 
+## Bootstrap is already included
+
+Tabler's JavaScript file contains Bootstrap's JavaScript. Do not load `bootstrap.bundle.js` or `import 'bootstrap'` next to it.
+
+<Warning title="Load Bootstrap only once">
+  With two copies on the page, every `data-bs-toggle` element gets two handlers. One click then opens two backdrops for a modal or an offcanvas, and dropdowns and tooltips open twice.
+</Warning>
+
+Use the components that Tabler exposes instead. With the script tag they are on the `tabler` global, for example `tabler.Modal` or `tabler.Offcanvas`. With a bundler, import them from the package:
+
+```js
+import { Modal, Offcanvas } from '@tabler/core'
+```
+
+If you need your own copy of Bootstrap's JavaScript, load only Tabler's CSS and leave `tabler.js` out.
+
 If you want to see what's possible, the demo pages at [preview.tabler.io](https://preview.tabler.io) show every layout and component in use. The rest of this documentation covers each of them in detail.