Working with projects

Understand project types, how to create and configure them, collaborate with a team, and manage everything from the CLI.

Working with projects

A project in VibeCaaS is a complete application environment. It bundles your source code and version control, a development environment with the cloud IDE, a database and storage, deployment configurations, and team collaboration features — all in one place.

This page covers the project lifecycle from creation through deployment.

Project types

VibeCaaS supports several kinds of project, each with sensible defaults.

Type	Good for	Frameworks
Web applications	Full-stack apps with SSR support	React, Vue, Angular, Next.js
APIs & backends	RESTful APIs and GraphQL servers	Node.js, Python, Go, Rust
Mobile apps	Cross-platform native and hybrid apps	React Native, Flutter, Ionic
Static sites	Documentation and marketing sites	Jekyll, Hugo, Gatsby

Creating a project

There are three ways to start a project.

From a template

Start with a pre-configured template for a popular framework:

vibecaas create my-app --template react-typescript

Import an existing project

Bring in code from GitHub, GitLab, or a zip upload:

vibecaas import https://github.com/user/repo

Blank project

Start from scratch with your own setup:

vibecaas create my-app --blank

Configuring a project

Environment variables

Each project has secure, encrypted storage for API keys and secrets:

DATABASE_URL=postgresql://...
API_KEY=sk-...
NODE_ENV=production

Variables are encrypted at rest and only accessible to your project. See Environments & secrets for per-environment configuration.

Build settings

Customize how your project is built and where output lands:

{
  "build": "npm run build",
  "output": "dist",
  "install": "npm install"
}

Team collaboration

Invite teammates by email or username and assign role-based permissions.

Role	Access
Owner	Full access to all features
Editor	Can edit code and deploy
Viewer	Read-only access

Projects also include Git integration with branch protection, pull requests, and code reviews, plus real-time presence so you can see who else is in the workspace.

Deployment

Projects deploy to Vercel, Netlify, AWS, and more. The pipeline is consistent:

Code is pushed to the repository.
An automatic build is triggered.
Tests run and must pass.
The app is deployed to production.

Full details are in Deploying your app.

Advanced features

Database integration — managed PostgreSQL with automatic backups (Supabase, Neon, MongoDB Atlas)
Monitoring & analytics — request/response times, error tracking, resource usage
Backup & recovery — daily automatic backups with one-click restore
Custom domains — bring your own domain with free SSL

Managing projects from the CLI

# Create a new project
vibecaas create my-app
 
# List all projects
vibecaas projects list
 
# Delete a project
vibecaas projects delete my-app
 
# Deploy to production
vibecaas deploy --prod

Next steps

Configure isolated environments in Environments & secrets.
Ship your project with Deploying your app.
Attach a domain in Custom domains.