import { InlineIcon } from "docs-ui" import { EllipsisHorizontal } from "@medusajs/icons"

export const metadata = { title: Manage Projects, }

{metadata.title}

Learn how to manage your Bloom projects, including renaming, accessing your store and admin, inviting team members to your project's admin dashboard, and deleting projects.

View Your Projects

You can view and manage all your Bloom projects from the account page.

To view your projects:

Open the Bloom homepage while you're logged in.
Find all projects under the "All projects" section.

Click on any project card to open the project interface and start customizing your store.

Each project card shows a preview of your store and when it was last edited.

Create a New Project

Refer to the Build Your First Bloom guide for a complete walkthrough of creating your first store project with Bloom.

</Note>

To create a new project as a logged-in user:

Open the Bloom homepage.
Click the "New Project" button.

On the project-creation page, you can either create a project by entering a custom prompt or by selecting a starter.

Both options build a store for you to customize, but starters provide a pre-designed store with specific features, while custom prompts let you describe your ideal store from scratch.

Rename a Project

By default, Bloom generates a store name based on your starter or prompt. Rename your project to better organize and identify your stores.

To rename a project:

Open the Bloom homepage while you're logged in.
Hover over the project to rename.
Click the <InlineIcon Icon={EllipsisHorizontal} alt="three dots" /> at the bottom right of the project.
Choose "Rename" from the menu.
In the pop-up, enter the new project name and click "Save".

The new project name displays throughout Bloom, including the project menu and account page.

Access Project Store and Admin

You can access a project's store and admin dashboard in both preview and published instances. Preview instances let you test changes before publishing, while published instances can be browsed by customers and managed by merchants.

Access Preview Store and Admin

To access the preview store and admin dashboard while building your store:

In the project interface, look at the toolbar at the bottom of the preview panel.
Click "Store" to view your store as customers see it.
Click "Admin" to access the admin dashboard for managing products, orders, and settings.

Access Published Store and Admin

After publishing your store, access the live store and admin dashboard that customers and team members use.

To access a project's published store and admin dashboard:

Open your project in Bloom.
Look for the "Publish" button in the top-right corner.
If you've already published your store, you'll see buttons for:
- Visit store: Opens your live store where customers browse and shop.
- Open admin: Opens the admin dashboard of your published store where you and your team manage the business.

Invite Admin Users to Published Store

You can invite team members to access the admin dashboard of your published store. They can manage products, orders, customers, and other aspects of the business.

There are no limits on how many users you can add to your project's admin dashboard.

</Note>

To invite users to access your published project's admin dashboard:

Open your published project's admin dashboard.
Go to Settings → Users.
Click the Invite button.
Enter the user’s email.
Once done, click on the "Send invite" button.

The invited user will receive an email with instructions to access the admin dashboard.

For detailed instructions on managing users and invites, see the Medusa Admin User Guide.

</Note>

Deploy New Changes

After publishing your store, you can continue making website and design changes to your store with Bloom. These changes will only be visible in the preview store until you publish the changes.

To publish new changes:

Open your project in Bloom.
Click the Publish button in the top-right corner of the project interface
Click on the Deploy changes button to deploy your latest changes to your live store.

This re-deploys your store with the latest changes you've made in Bloom. Publish as many times as needed to keep improving your store over time.

Delete a Project

Deleting a project is permanent and can't be undone. This deletes your preview store, published store (if available), and all data and code. Consider exporting your code first.

</Note>

You can permanently remove a project and all its data from Bloom.

To delete a project:

Open the Bloom homepage while you're logged in.
Hover over the project to delete.
Click the <InlineIcon Icon={EllipsisHorizontal} alt="three dots" /> at the bottom right of the project.
Choose "Delete" from the menu.

Other Project Settings

Explore additional settings to customize and configure your Bloom project.