What is a Project?
A project in PicaDeck represents a single database schema. It is the container that holds all your tables, columns, relationships, custom types, and (if git mode is enabled) branches and commits.
Each project is tied to a specific database type — PostgreSQL, MySQL, or MongoDB — which determines the available data types and the format of exported migrations.
Projects belong to an organization and can be shared with team members who have appropriate access levels.
Creating a Project
To create a new project, click the New Project button on your Projects dashboard. You will need to provide:
| Field | Required | Description |
|---|---|---|
| Name | Yes | A descriptive name for your project (e.g., "E-commerce API") |
| Description | No | Optional summary of what the database is for |
| Database Type | Yes | PostgreSQL, MySQL, or MongoDB |
| Git Mode | No | Enable version control (Pro/Team plans only) |
Note
Project Settings
Access project settings by clicking the settings icon on the project details page. Here you can:
- Rename the project — update the display name at any time
- Update the description — keep your team informed about the project's purpose
- Change database type — switch between PostgreSQL, MySQL, and MongoDB. Note that some data type mappings may not translate perfectly between databases
Danger Zone
Managing Team Members
You can invite team members to your project and assign them different access levels:
| Role | Permissions |
|---|---|
| Admin | Full access: edit schema, manage branches, change settings, manage members |
| Edit | Edit the schema and create branches. Cannot change project settings or manage members |
| View | Read-only access to view the schema. Cannot make any changes |
To add a member, go to the project's team settings and enter their email address. They will receive an invitation to join the project.
Favorite Projects
Star a project to add it to your Favorites section in the dashboard sidebar. This gives you one-click access to the projects you work on most frequently.
To favorite a project, click the star icon on the project card or in the project header. Favorited projects appear in the sidebar below the main navigation items.
Deleting a Project
To delete a project, go to Project Settings and scroll to the Danger Zone. You will be asked to confirm by typing the project name. Deletion permanently removes:
- All tables, columns, relationships, and custom types
- All branches and commits (if git mode was enabled)
- All pull requests and reviews
- All team member access
Warning