---
title: Quickstart
description: "The shortest path from an empty account to a live review widget."
---

Follow this path when setting up a new location or checking that the system is ready to publish.

<Steps>
  <Step title="Sign in to the admin panel">
    Open `/admin`. The root URL redirects to the Filament admin panel, and `/login` redirects to the Fortress login route.
  </Step>

  <Step title="Create a location">
    Add a location with a unique name, slug, address fields, and latitude/longitude. If Google Business Profile import is used, connect the location to its GBP location identifier.
  </Step>

  <Step title="Add projects">
    Create projects for completed customer work. Include the project date, location, title, customer type, customer contact details, description, tags, and project photos.
  </Step>

  <Step title="Add or import reviews">
    Add reviews manually, link them to projects when possible, or use the location table's Google review action to pull reviews from Google Business Profile.
  </Step>

  <Step title="Create a widget">
    Choose a widget type: map, project gallery, or review feed. Assign the widget to a location and set the minimum rating for reviews that should be shown.
  </Step>

  <Step title="Publish the embed">
    Use the widget embed script from `/widget/{widget}/embed.js` on the public site. The script injects the right markup, styles, and data for the selected widget type.
  </Step>
</Steps>

## Common First Checks

| Check | Why it matters |
| --- | --- |
| Location has latitude and longitude | Map widgets use the location address as the default center. |
| Projects have geolocation | Map markers come from project coordinates. |
| Projects have public media | Project gallery widgets only show projects with media. |
| Reviews have rating and text | Review feed and gallery filters require rating and visible review text. |
| Widget has a location | Widget rendering loads the location, projects, reviews, and media behind it. |

## Local URL

When served through Laravel Herd, the app is expected to be available at the project domain, usually `https://review-manager.test`.