Skip to content
GitHubGet started
HomeBlogChangelogCloudGitHub
Docs
Get started
QuickstartSet up with an AI agent
Tutorial
Step 1: Simple landing pageStep 2: Add a list of blocksStep 3: Add a root for shared layout contentStep 4: Adding a blogStep 5: Use a catch-all slug route
Upgrading from 1.x
Content model
Schema
TypeDocument
Fields
PathTextRich TextListTabsSelectNumberCheckDate & timeCodeObjectLinkEntryUrlFileImage
Workspaces and roots
RootsMedia
Querying content
StructuralFilteringRelatedAdvancedExamples
Guides
Live previewsInstant publishingEditing contentInternationalizationRoles and permissionsTypeScript
Deploying
Self-HostedAlinea Cloud
Working with AI agentsMCP server
Dashboard UI
Components
AlertAppShellBadgeBlockquoteBreadcrumbButtonCalendarCheckboxCheckboxGroupCodeCollapsibleColorSwatchPickerComboBoxCommandContentCardContentGridDataListDateFieldDatePickerDateRangePickerDialogDropdownMenuDropZoneEmptyFieldFileTriggerFoldIconHeadingIconKbdLinkListMediaPreviewMultipleSelectNavRailNumberFieldPagePopoverPreviewFrameRadioGroupResizablePanelGroupSearchFieldSelectSidebarSortableListSpinnerSurfaceSwitchTableTabsTagGroupTextTextFieldTimeFieldTimestampToggleToggleGroupToolbarTooltipTree
Custom fieldsOverviews
Reference
ConfigurationCLI
GitHubGet started
Alinea Cloud
Documentation

Alinea Cloud

Alinea Cloud is a hosted backend for your handler. It signs editors in, lets you invite users and give them roles, stores uploads and commits changes to your git repository. You don't need a database or auth provider of your own.

Connect your site

  1. Prepare and deploy your site with a handler that has no backend option: createHandler({cms}).

  2. Open the dashboard on your deployed site (/admin, or your adminPath). It shows Ready to deploy? because no backend is configured yet.

  3. Choose Continue with alinea.cloud and follow the setup on Alinea Cloud. It gives you an API key for your site.

  4. Add the key to your hosting environment as ALINEA_API_KEY and redeploy.

Alinea Cloud then verifies the connection with a handshake request to your handler. From there on editors sign in on /admin with their Alinea Cloud account.

Terminal
ALINEA_API_KEY=alineapk_...

Users and roles

Invite editors from Alinea Cloud. During the handshake your handler reports the roles defined in your config, with their labels and descriptions, so you can assign them to users there. The Manage users screen of the self-hosted dashboard isn't used with Alinea Cloud.

Good to know

  • ALINEA_API_KEY identifies your site, keep it secret. Without it the dashboard keeps showing the setup screen.

  • Your content stays in your repository. Alinea Cloud commits to it for you, so you can move to a self-hosted backend later without migrating content.

  • Local development doesn't use Alinea Cloud: alinea dev saves to your local files.