> ## Documentation Index
> Fetch the complete documentation index at: https://build.onswig.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a Project

This guide walks you through creating a new project in the Swig Developer Portal.

## Prerequisites

Before creating a project, ensure you have:

* A Swig account at [dashboard.onswig.com](https://dashboard.onswig.com)
* A **verified email address** (required for project creation)

<Warning>
  You must verify your email before creating projects. Check your inbox for the verification link.
</Warning>

## Automatic Project

When you first sign up for Swig, a project is automatically created for you with:

* **You as the Owner** - Full control over the project
* **FREE subscription** - Access to basic features
* **1 API key slot** - For programmatic access
* **1 team seat** - Just you to start

You can start using this project immediately or create additional projects for different applications.

## Creating a New Project

### Step 1: Access Project Settings

1. Log in to the [Developer Portal](https://dashboard.onswig.com)
2. Click on your project name in the sidebar
3. Click **Create New Project** or access via the project dropdown

### Step 2: Enter Project Details

1. **Project Name** (required)
   * 1-100 characters
   * Use a descriptive name (e.g., "Acme Corp", "My DeFi Project")
   * Can be changed later

2. Click **Create Project**

### Step 3: What Gets Created

When you create a project, the system automatically:

1. **Creates the project record** with you as the owner
2. **Activates a FREE subscription** for immediate use
3. **Creates your membership** with the OWNER role

## After Creation

Once your project is created, you can:

### Invite Team Members

Add collaborators with appropriate roles:

* Go to **Members** in the sidebar
* Click **Invite Member**
* Enter their email and select a role

### Create API Keys

Generate keys for programmatic access:

* Go to **API Keys** in the sidebar
* Click **Create API Key**
* Copy and securely store the key

### Set Up Policies

Define wallet permissions:

* Go to **Policies** in the sidebar
* Create signers and permissions
* Combine them into policies

### Upgrade Your Subscription

Access more features:

* Go to **Billing** in the sidebar
* Choose a plan (PRO, ULTRA, or ENTERPRISE)
* Complete the payment process

## Project Limits

### FREE Tier Limits

| Resource   | Limit         |
| ---------- | ------------- |
| API Keys   | 1             |
| Team Seats | 1             |
| Paymasters | Not available |

### Paid Tier Limits

| Resource   | PRO       | ULTRA     | ENTERPRISE |
| ---------- | --------- | --------- | ---------- |
| API Keys   | Unlimited | Unlimited | Unlimited  |
| Team Seats | Limited   | Limited   | Unlimited  |
| Paymasters | Yes       | Yes       | Yes        |

## Multiple Projects

You can create and manage multiple projects:

### Use Cases

* **Separate applications** - Keep different products isolated
* **Client work** - Maintain separate billing per client
* **Environments** - Split development and production

### Switching Projects

1. Click the project dropdown in the sidebar
2. Select the project you want to switch to
3. The dashboard updates to show that project's resources

## Project Settings

After creation, you can configure:

### General Settings

* **Name** - Update the project name
* **Policy Admin** - Set a Solana public key for admin authority

### Danger Zone

* **Delete Project** - Permanently remove the project
  * Only owners can delete
  * This action cannot be undone
  * All resources (API keys, policies, paymasters) are deleted

<Warning>
  Deleting a project is permanent. Make sure to export any data you need before deletion.
</Warning>

## Troubleshooting

### "Email not verified" Error

If you see this error when creating a project:

1. Check your inbox for the verification email
2. Click the verification link
3. Try creating the project again

### Project Not Appearing

If your new project doesn't appear:

1. Refresh the page
2. Check the project dropdown
3. Log out and log back in

## Next Steps

Now that you have a project:

* [Invite team members](./manage-members) to collaborate
* [Create an API key](./create-api-key) for programmatic access
* [Set up policies](./create-policy) for wallet permissions
* [Upgrade your subscription](./subscriptions-billing) for more features
