Projects

A project is one app Alaf Server knows how to build and run. This is where you find every app you've deployed and go into any one of them to change how it runs. There are two screens: the Projects list (everything at a glance) and the project detail screen (one project, nine tabs).

The Projects list

Open Projects from the left nav. This screen is a single scannable list of every project in your workspace — one row per project.

Each row shows, left to right: the app's icon (its favicon, or the framework logo), the name and its live version badge, the primary domain, the detected framework, where it's hosted (Cloud, a Server by name, or Local), its source (a GitHub repo or a local folder), the build shape (Services, Static, or Standalone), how long ago it changed, and a status pill (Live, Building, Failed, Draft, and so on). Click anywhere on a row to open that project.

Create Project

The Create Project button (top-right) takes you to the Library, where you pick a GitHub repository, a local folder, or a template to deploy. See Deploy from GitHub and Deploy a local folder.

Search

Once you have more than three projects, a search box appears above the list. It filters by name, slug, and framework as you type.

Filter by target

When your projects span more than one deploy target, a Filter by target card appears in the right column. It groups projects by where they run — All projects, Alaf Server Cloud, each connected server (by its name), and Local — with a count beside each. If you have no server-hosted projects yet, that column instead shows a Connect a server prompt (see Custom servers).

The project detail screen

Clicking a project opens its detail screen at the Overview tab. The layout is the same on every tab: a breadcrumb (Dashboard / project name / tab) and the tab title at the top, the tab's content in the main column, and a sticky right column with the project card and tab navigation.

The right-column project card shows the current status, the Production URL (or Local address) with a link out to the live site, and the Last Deploy time. When a project has more than one domain, a domain switcher lets you pick which one the card and Overview analytics reflect.

The environment switcher

The pill in the top-right shows the current environment (for example Production) and its git branch. Click it to switch between environments, or use the + button next to it to spin a new one up from a branch — pick a branch and Alaf Server creates a matching environment (a main or master branch becomes production, anything else a preview). Manual environment lets you name one yourself. Full walkthrough: Preview environments.

The nine tabs

Each tab has its own URL under /projects/{id}/…, so you can link straight to one. A services-only project (multiple compose services, no single app) hides the Configuration tab, since each service carries its own build config under Services.

Overview

…/overview — the project's home. Shows live analytics for the selected domain plus two summary cards: Infrastructure (where and how it runs) and Source & CI/CD (the connected repo and deploy settings). A project that has never deployed successfully shows a focused "ready to deploy" screen here instead. See Logs & monitoring.

Services

…/services — for multi-service (docker-compose / monorepo) projects. Lists each service and lets you start, stop, restart, and configure them individually. See Compose & multi-service.

Domains

…/domains — attach web addresses to the project, preview the DNS records they need, verify them, and manage SSL. See Custom domains and the Domains API.

Deployments

…/deployments — the full deploy history. Every build for this project, its status, and the controls to redeploy the latest or roll back to an earlier one. See Rollback & redeploy.

Source

…/source — the connected git repository: which repo and branch it deploys from, recent commits, and the Auto-deploy switch that rebuilds on every push. Upload/local projects show a "connect a repository" prompt here instead. See Auto-deploy on push.

Configuration

…/runtime — labeled Configuration in the UI. A read-only summary of how a single-app project builds and runs: framework, package manager, runtime isolation, port, and the install / build / output / root-directory settings. An Edit button reopens the deploy wizard to change any of them. The project's environment variables are edited here too. See Environment variables and Sleep mode & resources.

Logs

…/logs — the project's live output. Switch between the Terminal view (streamed runtime logs) and the Server / Requests view (HTTP request logs). On multi-service projects you can pick which service's logs to watch. See Logs & monitoring.

Backup

…/backup — schedule and manage backups: pick a destination, set per-service backup policies, and browse recent runs to restore or protect a snapshot from pruning. See Backups & restore.

Advanced

…/advanced — project-level actions and the danger zone. It opens with the route rules editor, then a Project Info summary and a Project Status card whose Disable / Enable button pauses or resumes the project. The red Danger Zone at the bottom holds Delete Project, which permanently removes its deployments, domains, environment variables, and analytics.

Where to next