Add architecture chapter

MatinAniss · MatinAniss · commit 7590cc456b2e · 2025-04-01T23:54:23.000+11:00
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
@@ -5,6 +5,9 @@
 - [Getting Started](getting-started/index.md)
   - [Create GPUI App](getting-started/create-gpui-app.md)
   - [Manual Project](getting-started/manual-project.md)
+- [Architecture](architecture/index.md)
+  - [Application](architecture/application.md)
+  - [Window](architecture/window.md)
 - [State Management](state-management/index.md)
   - [Entity](state-management/entity.md)
   - [Global](state-management/global.md)
diff --git a/src/architecture/application.md b/src/architecture/application.md
@@ -0,0 +1,19 @@
+## Application
+
+The `Application` is the entry point into your GPUI application.
+
+### Creating an Application
+
+The `new` function creates the `Application`.
+
+```rust
+{{ #include snippets/creating_an_application.rs }}
+```
+
+### Running an Application
+
+The `run` function consumes the `Application` and takes a callback which will be fired once the application has finished loading. This callback is the entry point into your application, a mutable reference of `App` is supplied where you can start controlling aspects of your application like opening a [window](./window.md).
+
+```rust
+{{ #include snippets/running_an_application.rs }}
+```
diff --git a/src/architecture/index.md b/src/architecture/index.md
@@ -0,0 +1,3 @@
+# Architecture
+
+In this chapter, you will learn the architecture of GPUI.
diff --git a/src/architecture/snippets/creating_an_application.rs b/src/architecture/snippets/creating_an_application.rs
@@ -0,0 +1,5 @@
+use gpui::Application;
+
+fn main() {
+    let application = Application::new();
+}
diff --git a/src/architecture/snippets/opening_a_window.rs b/src/architecture/snippets/opening_a_window.rs
@@ -0,0 +1,10 @@
+use gpui::{Application, WindowOptions};
+
+fn main() {
+    Application::new().run(|app| {
+        app.open_window(WindowOptions::default(), |window, app| {
+            // Return root view
+        })
+        .unwrap();
+    });
+}
diff --git a/src/architecture/snippets/running_an_application.rs b/src/architecture/snippets/running_an_application.rs
@@ -0,0 +1,9 @@
+use gpui::Application;
+
+fn main() {
+    let application = Application::new();
+
+    application.run(|_app| {
+        // Entry point
+    });
+}
diff --git a/src/architecture/window.md b/src/architecture/window.md
@@ -0,0 +1,11 @@
+## Window
+
+`Window`'s contain the views and components that will be rendered in your application, they each correspond to a platform window.
+
+### Opening a Window
+
+Using `App` you can access the `open_window` function which takes a `WindowOptions` and a callback which supplies mutable references to a `Window` and `App` that is used to build the root view. To learn more on how views are created you can read the [Render section](../rendering/render.md).
+
+```rust
+{{ #include snippets/opening_a_window.rs }}
+```

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Architecture`
	`2`	`+`
	`3`	`+In this chapter, you will learn the architecture of GPUI.`