Stars

Getting started

This page walks you through creating your PortalJS Cloud account, signing in, and finding your way around the admin dashboard.

Sign up

  1. Open the PortalJS Cloud sign-up page.

    placeholder: sign-up page

  2. Fill in the form:

    • Email address — used to sign in.
    • Password and Confirm password.
    • Organization title — the display name for your organization. A slugified version of this becomes your portal subdomain, for example my-org.portaljs.com.

  3. Complete the verification challenge and click Sign up.

  4. After your account is created, PortalJS Cloud automatically:

    • Signs you in.
    • Creates a GitHub repository for your portal frontend.
    • Deploys your public portal.

You can keep working in the admin dashboard while the portal builds in the background.

Sign in

  1. Open the sign-in page.

    placeholder: sign-in page

  2. Enter your email and password, complete the verification challenge, and click Sign in.

  3. You land on the Datasets page by default.

Forgot your password

  1. From the sign-in page, click Forgot password?.

  2. Enter your email and submit. You will receive a reset email.

  3. Click the link in the email and set a new password on the reset page.

    placeholder: forgot-password page

Tour of the admin dashboard

After signing in, you see the admin shell. The sidebar on the left is the main navigation.

placeholder: full dashboard layout

Sidebar — top

  • Create my portal / Visit my portal — shows the current deployment state of your public portal site. See Portal.
  • Portal repo link — opens the GitHub repository that holds your portal frontend code.

Sidebar — navigation

ItemWhat it does
DashboardStats, recently updated datasets, activity stream
DatasetsBrowse, create, edit datasets and their resources
VisualizationsPublish and manage visualizations
GroupsCategorize datasets into thematic groups
OrganizationsManage organizations and their members
UsersInvite and list users in your portal
HarvestersConfigure automated dataset syncing from external sources
MCP serverConnect AI chatbots to your portal data

Sidebar — bottom

  • Plan status (during trial) — shows your current plan and trial date.
  • Your profile — opens the profile/API-keys area.
  • Suggest a feature — opens a feedback form.
  • Sign out.

Dashboard widgets

The main Dashboard page shows:

  • Datasets stats — counts and recent activity.
  • Recently updated datasets — quick links to your latest work.
  • Activity stream — chronological log of changes in the portal.

placeholder: dashboard widgets

Next steps