Skip to main content
Creating a project on Pxxl starts with a GitHub repository. Pxxl reads the repository, detects the framework, and presents a configuration screen where you set the domain, port, environment variables, build commands, and scaling options before anything is provisioned. Nothing is created until you click Deploy Project, which means you have a full opportunity to review every setting first.
If the application already exists on Vercel, Netlify, Render, or Railway and you want to bring over provider metadata, build commands, and environment variables before creating the Pxxl project, use Import Projects instead of the standard deploy flow.

​
Create and Deploy a Project

1

Open the deploy screen

Navigate to Dashboard > Deploy Project or Projects > Add New > Deploy from GitHub. Pxxl lists all repositories available to the connected GitHub account.
2

Choose a repository

Use the search field to find the repository when the list is long. Click Import beside the repository you want to deploy. Pxxl opens the deployment configuration screen before creating anything.
3

Configure project setup fields

Fill in the core project settings in the top section of the configuration screen.
4

Add environment variables

Open the Environment Variables panel and add any secrets, database URLs, API credentials, or feature flags the application needs before it starts. Add these before creating the project — your container will not start without required variables.Use clear, descriptive names for every variable. Avoid exposing server-side secrets through variables your frontend framework intentionally injects into browser bundles.
5

Review additional build settings and server options

Open Additional Build Settings if Pxxl’s auto-detection needs guidance. You can override:
  • Install command — e.g., npm ci, pip install -r requirements.txt
  • Build command — e.g., npm run build, go build ./...
  • Start command — e.g., npm start, gunicorn app:app
  • Root directory — when the deployable service lives in a subdirectory
  • Requirements file — for Python projects with non-standard file names
  • Package manager — npm, yarn, pnpm, or bun
  • Runtime version — pin the Node.js, Python, or other runtime version
Open Server and Scaling to review the default memory, CPU, build server tier, and scaling configuration. Adjust these before creating the project when you know the application needs more than the defaults.
6

Configure advanced options and deploy

Expand the Advanced Options section at the bottom of the configuration screen to configure deployment behavior.When all settings are correct, click Deploy Project. Pxxl queues the build and you can follow progress in Project > Deployments and Project > Live Logs.

​
Safe Create Pattern

Use this checklist before clicking Deploy Project to avoid common first-deploy failures.
  • Repository, branch, and target commit are correct.
  • Project domain name is unique and available.
  • Runtime port matches the port your application binds to (or your app reads PORT).
  • All required environment variables are added — database URLs, API keys, secrets.
  • Install, build, and start commands match the application’s actual build process.
  • Memory, CPU, and scaling settings are appropriate for the expected workload.
  • Advanced options such as blue-green deployment or build cache are configured intentionally.