Cloud Setup¶

Set up a cloud workspace to start designing chips with GDSFactory+ in your browser—no installation required. Work in a cloud-hosted VSCode environment with everything pre-configured.

Prefer local installation? See the Local Installation guide instead.

Step 1: Log In to the Customer Portal¶

Access the GDSFactory+ customer portal at https://prod.gdsfactory.com/sign-in.

If you're part of an organization:

• Use the credentials from your invitation email (sent by your organization admin)

Don't have an account?

• Sign up at https://prod.gdsfactory.com/sign-up
• You'll receive an email with login instructions once your account is created

Organization Admins:

• Watch this video to learn how to invite team members

Step 2: Connect Your GitHub Account (One-Time Setup)¶

Connect your GDSFactory+ account to GitHub to edit your projects in cloud workspaces.

Requirements:

• You must be an owner of a GitHub organization
• Your GitHub organization must exist before connecting

Step 3: Create Your First Workspace¶

3.1 Create the Workspace¶

1. Navigate to Workspaces in the left sidebar
2. Click + New Workspace

1. Enter a name for your workspace

   • We recommend: firstname-lastname (e.g., john-smith)
   • Or follow your organization's naming conventions

2. Select Project Type: template: cspdk-si220-public-sample-project

3. Click Create

3.2 Wait for Setup¶

Your workspace will appear in the dashboard with a setup message in the link field.

Setup takes about 1 minute. Once the link appears, click it to open your workspace.

3.3 Open the Workspace¶

You'll see a VSCode interface in your browser.

Ignore the port forwarding popup in the bottom left.

Click the GF+ button in the left sidebar to open the GDSFactory+ extension panel.

Troubleshooting¶

If you encounter issues, view the Docker logs:

1. Go back to the Customer Portal (where you created the workspace)
2. Click the Docker logs icon for your workspace

Next Steps¶

You're all set! Now you can:

Get started:

• Follow the Quickstart Guide to design your first circuit using the Cornerstone PDK

Use a different PDK:

• Learn about working with PDKs to explore other foundry PDKs

Watch video tutorials:

• Check out Video Tutorials for hands-on guides

Need help?

• Join the GDSFactory Community Slack