Connect Repository

Create a new repository or connect an existing one from the KiCad plugin.

Create a New Repository

Start fresh with a new Paplix repository:

Step 1: Open Create Dialog

  1. Open KiCad
  2. Click Paplix → New Project

Step 2: Configure Repository

  1. Enter a project name (e.g., "power-supply-v2")
  2. Add an optional description
  3. Choose visibility:
    • Public - Anyone can view
    • Private - Only you and collaborators can access
  4. Click Create

Step 3: Add Your Files

  1. The plugin creates a new project directory
  2. Save your KiCad project files to this directory
  3. Use Paplix → Sync to push your initial files

Connect an Existing Repository

Clone a repository from Paplix:

Step 1: Open Clone Dialog

  1. Open KiCad
  2. Click Paplix → Clone Project

Step 2: Select Repository

  1. Browse your available repositories
  2. Or search by name
  3. Select the repository you want to clone

Step 3: Choose Location

  1. Select a local directory for the project
  2. Click Clone
  3. Wait for the files to download

Step 4: Open Project

  1. Navigate to the cloned directory
  2. Open the .kicad_pro file in KiCad
  3. Start working!

Connect Existing Local Project

If you have a KiCad project that's not yet on Paplix:

Step 1: Create Repository

  1. Click Paplix → New Project
  2. Enter the project name
  3. Create the repository

Step 2: Move Files

  1. Copy your existing KiCad files into the new project directory
  2. Or initialize the repository in your existing project folder

Step 3: Initial Sync

  1. Click Paplix → Sync
  2. Enter a commit message like "Initial import"
  3. Push your files

Repository Settings

After connecting, you can configure:

Default Branch

The main branch for your project (usually main or master).

Collaborators

Add team members from the Paplix web interface:

  1. Go to your project on paplix.io
  2. Navigate to Settings → Collaborators
  3. Add team members by username or email

Webhooks

Configure notifications for changes:

  1. Go to Settings → Webhooks on Paplix
  2. Add webhook URLs for integrations
  3. Select which events trigger notifications

Multiple Repositories

The plugin supports working with multiple repositories:

  1. Clone multiple projects to different directories
  2. Switch between them by opening different .kicad_pro files
  3. Each project syncs independently

Troubleshooting

Repository Not Appearing

  • Ensure you're logged in to the correct account
  • Refresh the repository list
  • Check your permissions on Paplix

Clone Fails

  • Verify the repository exists and you have access
  • Check your internet connection
  • Ensure the target directory is empty or doesn't exist

Sync Errors

  • Make sure all KiCad files are saved
  • Close any editors that might lock files
  • Check for merge conflicts

Next Steps