Dashboard Overview

Complete guide to navigating and using the Parslinks dashboard

Dashboard Overview

The Parslinks dashboard is your command center for managing organizations, projects, deployments, and team members. This guide will help you understand each section and feature.

Dashboard Layout

The dashboard consists of several main areas:

1. Top Navigation Bar

The top navigation provides quick access to:

  • Organization Selector: Switch between your organizations
  • Search: Quickly find projects, deployments, or settings
  • Notifications: View deployment status and system notifications
  • User Menu: Access account settings and logout

2. Sidebar Navigation

The sidebar contains the main navigation menu:

  • Overview: Dashboard home with key metrics
  • Projects: All projects in the current organization
  • Deployments: Recent deployments and build history
  • Domains: Manage custom domains and SSL
  • Team: Manage team members and permissions
  • Settings: Organization and project settings
  • Billing: Subscription and payment management
  • Analytics: Usage statistics and performance metrics

3. Main Content Area

The central area displays the current page content, whether it's:

  • Project lists
  • Deployment logs
  • Settings forms
  • Analytics charts

Overview Page

The overview page is your dashboard home, showing:

Key Metrics

┌─────────────────────────────────────────────────────┐
│  Total Projects: 12    Active Deployments: 5        │
│  Total Domains: 8      Monthly Bandwidth: 45.2 GB   │
└─────────────────────────────────────────────────────┘

Recent Deployments

A timeline of your most recent deployments with:

  • Deployment status (Success, Building, Failed)
  • Project name
  • Commit message (if Git connected)
  • Deployment time
  • Quick actions (View, Redeploy, Logs)

Quick Actions

  • New Project: Create a new project
  • New Deployment: Deploy an existing project
  • Invite Team Member: Add someone to your organization
  • View Analytics: Check usage and performance

Projects Page

The Projects page shows all projects in your organization.

Project List View

Each project card displays:

  • Project Name: Clickable to view project details
  • Status: Active, Paused, or Archived
  • Last Deployment: Time and status of last deployment
  • Production URL: Quick link to live site
  • Framework: Detected or configured framework

Project Filters

Filter projects by:

  • Status: Active, Paused, Archived
  • Framework: Next.js, React, Vue, etc.
  • Last Deployed: Today, This week, This month
  • Search: Search by name or slug

Project Actions

Hover over a project to access quick actions:

  • Deploy: Trigger a new deployment
  • Visit: Open the production URL
  • Settings: Configure project settings
  • Logs: View deployment and runtime logs

Project Details Page

Click on a project to see detailed information:

Overview Tab

  • Production Deployment: Current live deployment
  • Git Integration: Connected repository and branch
  • Environment: Current framework and runtime
  • Quick Deploy: Button to trigger immediate deployment

Deployments Tab

Complete deployment history with:

  • Deployment status and timeline
  • Commit information
  • Build duration
  • Preview URLs for each deployment
  • Build logs
  • Actions (Promote, Rollback, Cancel)

Domains Tab

Manage domains for this project:

  • Production domain
  • Preview domains
  • Custom domains
  • SSL certificate status
  • DNS configuration guide

Settings Tab

Configure project settings:

  • General: Name, framework, root directory
  • Build & Development: Build commands, environment
  • Git: Repository, branch, auto-deploy settings
  • Environment Variables: Manage variables by environment
  • Advanced: Node version, package manager, caching

Deployments Page

View all deployments across all projects:

Deployment List

Columns include:

  • Status: Building, Ready, Failed, Cancelled
  • Project: Which project was deployed
  • Branch/Commit: Git information
  • Duration: Build time
  • Deployed: How long ago
  • Actions: View, Logs, Promote, Rollback

Deployment Filters

Filter by:

  • Status: All, Building, Ready, Failed
  • Project: Select specific project
  • Date Range: Custom date ranges
  • Branch: Filter by Git branch

Deployment Actions

Click on a deployment to:

  • View Logs: See complete build output
  • Promote to Production: Make this deployment live
  • Rollback: Revert to this deployment
  • Redeploy: Build again with same settings
  • Cancel: Stop an in-progress build

Domains Page

Manage all custom domains:

Domain List

Each domain shows:

  • Domain Name: The custom domain
  • Status: Active, Pending, Failed
  • SSL Status: Valid, Pending, Expired
  • Project: Which project it's connected to
  • Type: Production or Preview

Adding a Domain

  1. Click Add Domain
  2. Enter your domain name
  3. Select the target project
  4. Follow DNS configuration instructions
  5. Wait for verification

SSL Certificates

  • Automatic SSL: Free SSL certificates from Let's Encrypt
  • Auto-Renewal: Certificates renew automatically
  • Status Monitoring: Track certificate expiration

Team Page

Manage organization members and permissions:

Team Members List

View all members with:

  • Name and Email: Member information
  • Role: Owner, Admin, Member, Viewer
  • Status: Active, Invited, Suspended
  • Projects: Number of projects they can access
  • Last Active: Last login time

Inviting Members

  1. Click Invite Member
  2. Enter email address
  3. Select role and permissions
  4. Choose project access (All or Specific)
  5. Send invitation

Roles and Permissions

RolePermissions
OwnerFull access, billing, delete organization
AdminManage projects, members, settings
MemberCreate/deploy projects, view billing
ViewerRead-only access to projects

Settings Page

Configure organization and account settings:

Organization Settings

  • General: Name, slug, description, logo
  • Domains: Default domain configuration
  • Integrations: Git providers, Slack, webhooks
  • Security: Two-factor authentication, SSO
  • Notifications: Email and Slack notifications

Account Settings

  • Profile: Name, email, avatar
  • Authentication: Password, 2FA, connected accounts
  • Preferences: Language, timezone, theme
  • API Tokens: Personal access tokens

Billing Page

Manage subscription and billing:

Current Plan

  • Plan Name: Free, Pro, Team, Enterprise
  • Monthly Cost: Current subscription cost
  • Billing Period: Next billing date
  • Usage: Current usage vs. limits

Usage Metrics

Track your usage:

  • Bandwidth: GB transferred this month
  • Build Minutes: Time spent building
  • Concurrent Builds: Number of simultaneous builds
  • Team Members: Active members vs. limit

Invoices

  • Download past invoices
  • View payment history
  • Update payment method

Analytics Page

Monitor performance and usage:

Traffic Analytics

  • Page Views: Total views over time
  • Unique Visitors: Unique users
  • Top Pages: Most visited pages
  • Referrers: Where traffic comes from
  • Geographic Distribution: Visitor locations

Performance Metrics

  • Response Time: Average server response time
  • Build Time: Average deployment duration
  • Error Rate: Percentage of failed requests
  • Uptime: Service availability percentage

Resource Usage

  • Bandwidth: Data transfer over time
  • Build Minutes: Build time consumption
  • Storage: File storage usage
  • Function Invocations: Serverless function calls

Keyboard Shortcuts

Speed up your workflow with keyboard shortcuts:

ShortcutAction
Cmd/Ctrl + KOpen command palette
Cmd/Ctrl + PQuick project search
G → OGo to Overview
G → PGo to Projects
G → DGo to Deployments
G → SGo to Settings
N → PNew Project
N → DNew Deployment

Mobile Dashboard

Access your dashboard on mobile devices:

  • Responsive Design: Full functionality on mobile
  • Quick Actions: Easy access to deploy and view
  • Notifications: Push notifications for deployments
  • Logs: View deployment logs on the go

Customizing Your Dashboard

Personalize your experience:

Theme

  • Light Mode: Bright interface for daytime
  • Dark Mode: Easy on the eyes for nighttime
  • Auto: Matches system preference

Layout

  • Sidebar: Expanded or collapsed by default
  • Density: Compact or comfortable spacing
  • Cards: Grid or list view for projects

Tips for Efficient Dashboard Use

  1. Use Search: The search bar can find anything quickly
  2. Pin Favorites: Star frequently used projects
  3. Keyboard Shortcuts: Learn shortcuts for faster navigation
  4. Filters: Use filters to focus on what matters
  5. Notifications: Enable notifications for important events

Understanding Status Indicators

Deployment Status

  • 🟢 Ready: Successfully deployed and live
  • 🔵 Building: Currently being built
  • 🔴 Failed: Deployment failed (click for logs)
  • 🟡 Queued: Waiting to start building
  • Cancelled: Manually cancelled

Domain Status

  • Active: Domain is working correctly
  • Pending: Waiting for DNS propagation
  • Failed: Configuration error
  • ⚠️ SSL Pending: Certificate being issued

Project Status

  • 🟢 Active: Project is live and accessible
  • ⏸️ Paused: Deployments paused, site still accessible
  • 📦 Archived: Project is archived and inactive

Next Steps