From 9ee52192ed5a3890002f4e163d516c189cddda60 Mon Sep 17 00:00:00 2001
From: Erik Onarheim <erik.onarheim@gmail.com>
Date: Tue, 30 Apr 2024 20:55:50 -0500
Subject: [PATCH] docs: why use excalibur?

---
 site/docs/00-welcome.mdx       | 19 -------------------
 site/docs/00-why-excalibur.mdx | 28 ++++++++++++++++++++++++++++
 2 files changed, 28 insertions(+), 19 deletions(-)
 create mode 100644 site/docs/00-why-excalibur.mdx

diff --git a/site/docs/00-welcome.mdx b/site/docs/00-welcome.mdx
index 90069abf1..419d0f870 100644
--- a/site/docs/00-welcome.mdx
+++ b/site/docs/00-welcome.mdx
@@ -17,25 +17,6 @@ Get started by [installing Excalibur](/docs/installation) in your project and [b
 
 [![sweepstacks game](00-welcome/sweep.gif)](https://excaliburjs.com/sweep/)
 
-## Why use Excalibur?
-
-Excalibur is designed with approachability in mind. You can make some [classic favorites](/docs/getting-started) with just a few lines of code! Excalibur will meet you where you're at, whether you're new to game development or an experienced game maker.
-
-Excalibur has a ton of features to help you make games!
-
-- Objected-Oriented TypeScript first API
-- [Actors](/docs/actors) come prebuilt everything you need
-- [SpriteSheet](/docs/spritesheets), [Sprites](/docs/sprites), and [Animations](/docs/animation)
-- [Text and Font](/docs/text) support
-- Built in Math utilities like [Matrix](/docs/matrix) and [Vector](/docs/vector)
-- [Collision Detection](/docs/colliders)
-- [Arcade](/docs/physics#arcade) Style and [Realistic](/docs/physics#realistic) Physics
-- [2D](/docs/tilemap) and [Isometric](/docs/isometric) TileMaps
-- [Tiled](/docs/tiled-plugin) and [Aseprite](/docs/aseprite-plugin) integrations
-- Optionally write [custom WebGL Renderers](/docs/custom-renderer-plugins)
-- Optionally use [Entity-Component-System](/docs/entity-component-system) style development
-
-There are a lot of great tools out there to build games on the web and no tool is perfect. Use whichever tool makes you happiest. 😊
 
 ## Excalibur's Design Philosophy
 
diff --git a/site/docs/00-why-excalibur.mdx b/site/docs/00-why-excalibur.mdx
new file mode 100644
index 000000000..23221190b
--- /dev/null
+++ b/site/docs/00-why-excalibur.mdx
@@ -0,0 +1,28 @@
+---
+slug: /why-excalibur
+title: Why use Excalibur
+tags: ["#Tutorial"]
+---
+
+Excalibur is designed with approachability in mind. You can make some [classic favorites](/docs/getting-started) with just a few lines of code! Excalibur will meet you where you're at, whether you're new to game development or an experienced game maker.
+
+Excalibur has a ton of features to help you make games!
+<ul style={{listStyle: 'none', padding: 0 }}>
+    <li>📖 Lots of documentation at https://excaliburjs.com <ul><li>[Samples](/samples) & [Showcase](/showcase)</li></ul></li>
+    <li>📦 Objected-Oriented TypeScript first API similar to Unity/Godot</li>
+    <li>🎥 Friendly API based around a theater metaphor of [Scenes](/docs/scenes), [Actors](/docs/actors), and [Actions](/docs/category/actions/)</li>
+    <li>🏃[SpriteSheet](/docs/spritesheets), [Sprites](/docs/sprites), and [Animations](/docs/animation)</li>
+    <li>💥 Built in [collisions](/docs/colliders) with [Arcade](/docs/physics#arcade) and [Realistic](/docs/physics#realistic) Physics</li>
+    <li>🧩 [2D](/docs/tilemap) and [Isometric](/docs/isometric) TileMaps</li>
+    <li>🎨 [Custom shader](/docs/materials), [post-processing](/docs/postprocessors/) support, and [render plugins](/docs/custom-renderer-plugins)</li>
+    <li>🖼️ Auto-batching draw calls and really tuned draw performance</li>
+    <li>🎁 [Entity-Component-System](/docs/entity-component-system) under the hood when you need control</li>
+    <li>🛠️ Popular Game Dev Tool Support</li>
+    * [Tiled maps](/docs/tiled-plugin)
+    * [LDtk levels](/docs/ldtk-plugin)
+    * [Spritefusion levels](/docs/spritefusion-plugin)
+    * [Aseprite image files](https://github.com/excaliburjs/excalibur-aseprite)
+    * [JSFXR audio](https://github.com/excaliburjs/sample-jsfxr/)
+</ul>
+
+There are a lot of great tools out there to build games on the web and no tool is perfect. Use whichever tool makes you happiest. 😊