Skip to main content

Create a Project

Projects are the fundamental building blocks of your cloud infrastructure on Viduli. Think of a project as similar to a VPC (Virtual Private Cloud) in AWS - it provides an isolated environment where your applications, databases, and caches can securely communicate with each other while remaining separate from other projects.

Each project comes with its own dedicated API gateway, service mesh, and networking infrastructure, creating a complete application environment ready for deployment. This tutorial will guide you through creating your first project and setting up the foundation for your cloud applications.

Prerequisites​

Before creating a project, you'll need:

  • A Viduli account
  • An organization (created during onboarding)
  • A team within your organization

Step-by-Step Instructions​

1. Sign Up to Viduli​

If you haven't already, create your Viduli account by visiting the sign up page and clicking the sign-up button. You'll need to provide your email address and create a secure password.

2. Complete the Onboarding Process​

After signing up, Viduli's onboarding flow will automatically guide you through the initial setup:

  • Create an Organization: Choose a unique organization name and display label
  • Create a Team: Set up your first team within the organization (you can use "main" or "core" if you're unsure)

The onboarding process ensures you have the proper organizational structure in place before creating projects.

3. Access Project Creation​

Once your team is created, you'll see the main dashboard with a Create a Project button prominently displayed. This button appears when you have a team selected but no projects yet exist within that team.

4. Configure Your Project​

Click the Create a Project button to open the project creation dialog:

  • Display Label: Enter a user-friendly name that describes your project's purpose (e.g., "E-commerce API", "Marketing Website")
  • Project Name: Choose a unique identifier within your team (e.g., "ecommerce-api", "marketing-site")
tip

Naming Best Practices: Use descriptive names that clearly identify the project's purpose. The project name cannot be changed after creation, so choose carefully.

5. Create and Provision​

Click Confirm to create your project. Viduli will automatically begin provisioning the underlying infrastructure:

  • API Gateway: Routes external traffic to your applications
  • Service Mesh: Enables secure communication between resources
  • Networking: Sets up isolated network infrastructure
  • Security Policies: Configures default security settings
  • Default Domain: A *.viduli.app subdomain in the format organization-team-project.viduli.app for immediate access to your applications

The provisioning process typically takes 1-2 minutes to complete.

6. Verify Project Creation​

Once provisioning is complete, you'll see your new project appear in the project list. The project status will show as "Running," indicating that the infrastructure is ready to host your applications.

What's Next?​

Congratulations! You've successfully created your first Viduli project and established the foundational cloud infrastructure needed to build fully-featured cloud applications.

Your project now provides:

  • Isolated Environment: Secure boundaries for your application resources
  • Built-in Networking: Ready-to-use service mesh and API gateway
  • Scalable Foundation: Infrastructure that grows with your application needs

You're now ready to deploy your first resources. Continue to the next tutorial to learn how to deploy a web application to your newly created project.