Create Project
A Project is the main workspace for database design and development in Qubase. It contains your database schemas, ERD diagrams, SQL or DBML code, AI-powered tools, and collaboration history.
Every Project belongs to a single Workspace.
Before you begin
Before creating a Project, make sure that you:
- Have a verified Qubase account
- Are signed in to Qubase
- Have access to a Workspace
- Have permission to create Projects in the selected Workspace
[!NOTE] A Project cannot exist without a Workspace.
Create a Project
- Open your Workspace.
- Select Projects from the navigation menu.
- Click New Project.
- Enter the required information.
| Field | Description |
|---|---|
| Project Name | A unique and descriptive project name |
| Description | A brief explanation of the project (optional) |
| Database Type | Select the target database system (for example PostgreSQL or MySQL) |
- Review the project information.
- Click Create Project.
Project structure
Each Project can contain:
- Multiple Database Schemas
- ERD diagrams
- SQL or DBML source code
- AI-generated suggestions
- Version history
- Team collaboration
- Comments and discussions
Project permissions
Depending on your Workspace role, you may be able to:
| Permission | Description |
|---|---|
| View | Open and browse the Project |
| Edit | Modify database schemas and diagrams |
| Comment | Leave feedback on schemas |
| Manage | Configure project settings and members |
Permissions are managed by Workspace Owners or administrators.
What happens next?
After creating your Project, you can:
- Create your first Database Schema
- Open the Visual ERD Canvas
- Import an existing database
- Generate SQL or DBML
- Invite collaborators
- Use AI-powered database engineering features
Best practices
- Give each Project a meaningful name.
- Create separate Projects for different applications or systems.
- Use clear descriptions so team members understand the project’s purpose.
- Keep related database schemas within the same Project.
[!TIP] If your organization manages multiple applications, create one Project for each application instead of placing everything into a single Project.
Troubleshooting
I can’t create a Project
Verify that:
- You are inside a Workspace.
- You have permission to create Projects.
- The Workspace has not reached any project limits.
Which database type should I choose?
Select the database system that your application will use. This helps Qubase generate compatible SQL during Forward Engineering.