From 002d90670a0caadefd1609268a95d26109410af9 Mon Sep 17 00:00:00 2001
From: Vishal Kumar Singh <vishal.kr.singh2021@gmail.com>
Date: Sat, 16 May 2026 12:03:24 +0530
Subject: [PATCH] Add top-level array store examples to stores concept page

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/routes/(0)concepts/(5)stores.mdx | 44 ++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/src/routes/(0)concepts/(5)stores.mdx b/src/routes/(0)concepts/(5)stores.mdx
index 9b92a79e7f..4c523e4dbb 100644
--- a/src/routes/(0)concepts/(5)stores.mdx
+++ b/src/routes/(0)concepts/(5)stores.mdx
@@ -59,6 +59,50 @@ const [store, setStore] = createStore({
 });
 ```
 
+### Top-level array stores
+
+While the examples above show a store as an object with properties, stores can also be arrays directly.
+When creating a top-level array store, the setter syntax differs slightly since you target indices directly rather than navigating through property keys first.
+
+```jsx
+import { createStore } from "solid-js/store";
+
+// Store as a top-level array
+const [users, setUsers] = createStore([
+	{ id: 0, username: "felix909", location: "England", loggedIn: false },
+	{ id: 1, username: "tracy634", location: "Canada", loggedIn: true },
+	{ id: 2, username: "johny123", location: "India", loggedIn: true },
+]);
+```
+
+To append a new item to a top-level array store, use the array's length as the index:
+
+```jsx
+setUsers(users.length, {
+	id: 3,
+	username: "michael584",
+	location: "Nigeria",
+	loggedIn: false,
+});
+```
+
+To modify an existing item by index:
+
+```jsx
+// Update username of the first user
+setUsers(0, "username", "felix_updated");
+
+// Update multiple properties at once
+setUsers(1, { location: "USA", loggedIn: false });
+```
+
+You can also use filtering functions to update items based on conditions:
+
+```jsx
+// Log out all users from Canada
+setUsers((user) => user.location === "Canada", "loggedIn", false);
+```
+
 ## Accessing store values
 
 Store properties can be accessed directly from the state proxy through directly referencing the targeted property: