From a6141011c2bed071eb908f4468274f44e18dc64a Mon Sep 17 00:00:00 2001
From: Aylur <k.demeter@protonmail.com>
Date: Thu, 3 Oct 2024 21:39:40 +0000
Subject: docs: window toggling

---
 docs/guide/ags/cli-app.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

(limited to 'docs/guide/ags/cli-app.md')

diff --git a/docs/guide/ags/cli-app.md b/docs/guide/ags/cli-app.md
index ceed56a..93f9901 100644
--- a/docs/guide/ags/cli-app.md
+++ b/docs/guide/ags/cli-app.md
@@ -95,6 +95,42 @@ ags -m "return 'hello';"
 # hello
 ```
 
+## Toggling Windows by their name
+
+In order for AGS to know about your windows, you have to register them.
+You can do this by specifying a **unique** `name` and calling `App.add_window`
+
+```tsx
+import { App } from "astal"
+
+function Bar() {
+    return <window name="Bar" setup={self => App.add_window(self)}>
+        <box />
+    </window>
+}
+```
+
+You can also invoke `App.add_window` by simply passing the `App` to the `application` prop.
+
+```tsx
+import { App } from "astal"
+
+function Bar() {
+    return <window name="Bar" application={App}>
+        <box />
+    </window>
+}
+```
+
+:::warning
+When assigning the `application` prop make sure `name` comes before.
+Props are set sequentially and if name is applied after application it won't work.
+:::
+
+```sh
+ags -t Bar
+```
+
 ## App without AGS
 
 As mentioned before AGS is only a scaffolding tool. You can setup
-- 
cgit v1.2.3


From e8536ed29caca7b6fc7ef582a2cc31dfc8317c8d Mon Sep 17 00:00:00 2001
From: Aylur <104676705+Aylur@users.noreply.github.com>
Date: Thu, 3 Oct 2024 23:46:39 +0200
Subject: Update cli-app.md

highlight relative lines
---
 docs/guide/ags/cli-app.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'docs/guide/ags/cli-app.md')

diff --git a/docs/guide/ags/cli-app.md b/docs/guide/ags/cli-app.md
index 93f9901..9d5d21d 100644
--- a/docs/guide/ags/cli-app.md
+++ b/docs/guide/ags/cli-app.md
@@ -100,7 +100,7 @@ ags -m "return 'hello';"
 In order for AGS to know about your windows, you have to register them.
 You can do this by specifying a **unique** `name` and calling `App.add_window`
 
-```tsx
+```tsx {4}
 import { App } from "astal"
 
 function Bar() {
@@ -112,7 +112,7 @@ function Bar() {
 
 You can also invoke `App.add_window` by simply passing the `App` to the `application` prop.
 
-```tsx
+```tsx  {4}
 import { App } from "astal"
 
 function Bar() {
-- 
cgit v1.2.3


From dfc240d66e818044a24520726aef4e8e113a6dd7 Mon Sep 17 00:00:00 2001
From: Aylur <k.demeter@protonmail.com>
Date: Thu, 3 Oct 2024 21:43:52 +0000
Subject: docs: window toggling

---
 docs/guide/ags/cli-app.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'docs/guide/ags/cli-app.md')

diff --git a/docs/guide/ags/cli-app.md b/docs/guide/ags/cli-app.md
index 9d5d21d..ec6d174 100644
--- a/docs/guide/ags/cli-app.md
+++ b/docs/guide/ags/cli-app.md
@@ -112,7 +112,7 @@ function Bar() {
 
 You can also invoke `App.add_window` by simply passing the `App` to the `application` prop.
 
-```tsx  {4}
+```tsx {4}
 import { App } from "astal"
 
 function Bar() {
-- 
cgit v1.2.3