Projects & surfaces
A project groups the surfaces you collect feedback on and the pins left on them. Inside a workspace you might have one project for your marketing site, another for your app’s staging environment, and a third for a client engagement. Each keeps its own pins, so feedback on the marketing homepage never gets mixed in with bugs from staging.
Surfaces
A surface is a site within your workspace, identified by its hostname. When someone leaves the first pin on a new site, Skyelight creates the surface automatically and groups every later pin on that site under it. You do not register pages by hand.
- One surface is created per hostname (so
app.acme.comandacme.comare separate surfaces). - Document-style apps, like Google Docs, are split per document so each one is its own surface.
- A surface belongs to exactly one project at a time.
In the dashboard, each surface gets a tile in the workspace mosaic showing a screenshot, pin counts, and recent activity. Open a tile to see every pin anchored to that site.
Flows (coming soon)
Sometimes one site is really several journeys. Flows will let you split a
single surface into named sub-surfaces by URL path, so onboarding feedback does
not pile in with checkout feedback. You will define a flow with a route pattern,
for example /onboarding/* to capture that whole section, and new pins will be
routed to the most specific match.
Flows are part of Workflows, which is on the roadmap and not available yet. Today, all pins on a site land on that site’s single surface.
Creating a project
- Open your workspace. In the sidebar, expand Projects and choose Create project (admins and owners only).
- Name it after the site or environment it covers.
- Connect it to a surface: install the Chrome extension for sites you browse, or embed the chip widget on a product you own. The chip is always tied to one project; with the extension, the first pin on a new site lets you pick the project (or create one inline).
Need to move a site into a different project? On the surface’s tile in the dashboard, use the 3-dot menu and pick a new project. Reorganizing is done in the web app.
How projects scope what you see
A project is the unit you triage and synthesize by. Its home is a synthesis dashboard: a metric strip, a feed of decisions, and a tab for each feedback type. Pin types, the decisions view, and notifications all operate within the project. If you need a clean separation between two efforts (different sites, different clients, different stages), give each its own project rather than crowding them into one. See the Dashboard for the full tour.