diff --git a/images/usage-1.avif b/images/usage-1.avif deleted file mode 100644 index cf413f36..00000000 Binary files a/images/usage-1.avif and /dev/null differ diff --git a/images/usage-2.avif b/images/usage-2.avif deleted file mode 100644 index bc96f390..00000000 Binary files a/images/usage-2.avif and /dev/null differ diff --git a/images/usage-3.avif b/images/usage/tools/admin-portal.avif similarity index 100% rename from images/usage-3.avif rename to images/usage/tools/admin-portal.avif diff --git a/images/usage/tools/dashboard-components.png b/images/usage/tools/dashboard-components.png new file mode 100644 index 00000000..cd7c8692 Binary files /dev/null and b/images/usage/tools/dashboard-components.png differ diff --git a/images/usage/tools/dashboard-overview.png b/images/usage/tools/dashboard-overview.png new file mode 100644 index 00000000..95c75ea7 Binary files /dev/null and b/images/usage/tools/dashboard-overview.png differ diff --git a/usage/tools/powersync-dashboard.mdx b/usage/tools/powersync-dashboard.mdx index e77af60e..d79e7bbe 100644 --- a/usage/tools/powersync-dashboard.mdx +++ b/usage/tools/powersync-dashboard.mdx @@ -3,9 +3,7 @@ title: "PowerSync Dashboard" description: "Introduction to and overview of the PowerSync Dashboard and Admin Portal" --- -The PowerSync Dashboard is available with [PowerSync Cloud](https://www.powersync.com/pricing) (our cloud-hosted offering). - -The PowerSync Dashboard provides an interface for developers to: +The PowerSync Dashboard is available in [PowerSync Cloud](https://www.powersync.com/pricing) (our cloud-hosted offering) and provides an interface for developers to: * Manage PowerSync projects * Manage PowerSync instances @@ -19,11 +17,11 @@ The dashboard is available here: [https://powersync.journeyapps.com/](https://po ### Hierarchy: Organization, project, instance * After successfully [signing up](https://accounts.journeyapps.com/portal/get-started?powersync=true) for PowerSync Cloud, your PowerSync account is created. -* Your account is assigned a new "Trial" **organization** on the [Free pricing plan](https://www.powersync.com/pricing). (Note that the use of the term "Trial" is temporary and will be removed in a future release — You have indefinite access to the PowerSync Free plan, not a time-limited trial) -* A sample PowerSync **project** (named "Trial Project") is automatically created in this organization, and this project is your starting point after completing sign-up. It is opened by default in the dashboard: +* Your account is assigned an **organization** on the [Free pricing plan](https://www.powersync.com/pricing). +* A sample PowerSync **project** (named "PowerSync Project") is automatically created in this organization, and this project is your starting point after completing sign-up. It is opened by default in the dashboard: - + * Within a project, you can create and manage one or more PowerSync **instances** for your project (typically developers maintain a staging and production instance). An instance runs a copy of the [PowerSync Service](/architecture/powersync-service) and connects to your Postgres database. @@ -32,8 +30,8 @@ Here is an example of how this hierarchy might be used by a customer: * **Organization**: Acme Corporation * **Project**: Travel App - * **Instance**: Staging - * **Instance**: Production + * **Instance**: Staging + * **Instance**: Production ### Dashboard layout @@ -45,17 +43,19 @@ The Dashboard layout is similar to that of an IDE and includes the following mai * [Actions](/usage/tools/powersync-dashboard#actions) - + #### Workspaces Workspaces are a pre-configured logical collection of editor panes and panels that are designed to make working on a specific part of your project as easy as possible. -The dashboard comes with two workspaces by default: **Default Workspace** and **Metrics**. +The dashboard comes with four workspaces by default: **Overview**, **Manage instances**, **Usage metrics** and **Instance logs**. -* The Default Workspace is configured to manage instances, update, validate and deploy sync rules. -* The Metrics workspace displays your project's usage metrics. +* The **Overview** workspace presents an overview of your PowerSync instances, or guides you through creating your first instance. +* The **Manage instances** workspace is allows you to create, view and update PowerSync instances, validate and deploy sync rules, and view deploy logs by instance. +* The **Usage metrics** workspace displays your project's usage metrics by instance. +* The **Instance logs** workspace displays replication and service logs by instance. You can customize any of these workspaces (changes save automatically) and/or create new workspaces. @@ -108,7 +108,7 @@ It is available here: - +