Ideon Logo
Ideon

Integrations

Ideon integrates with your existing tools to provide a unified visual workspace for your projects and deployments.

Vercel Integration

The Vercel integration allows you to monitor and manage your deployments directly from the Ideon canvas.

Setup

To connect your Vercel account, go to the Integrations page and select Vercel. Depending on your system configuration, you can use one of the following methods:

Method 1: OAuth (Recommended)

This is the most seamless way to connect. It requires that your Ideon administrator has configured a Vercel Client ID and Secret.

  1. Click the "Sign in with Vercel" button.
  2. You will be redirected to the Vercel authorization page.
  3. Review the permissions and click "Authorize".
  4. Once successfully authorized, you will be redirected back to Ideon, and your projects will be available for selection.

[!NOTE] OAuth automatically handles Team ID associations if you use a team-specific authorization flow on Vercel.

Method 2: Personal Access Token (PAT)

If OAuth is not configured or if you prefer using a token, you can manually connect using a Personal Access Token.

  1. Log in to your Vercel Dashboard.
  2. Navigate to Account Settings > Tokens.
  3. Create a new token (e.g., named "Ideon").
  4. Copy the token (it usually starts with vcp_).
  5. In Ideon, paste the token into the Personal Access Token field.
  6. Click "Connect".

[!IMPORTANT] Ensure your token has the necessary scopes to read "Projects" and "Deployments" for the integration to function correctly.

Administrative Setup

Administrators must enable and configure the integration via the Ideon UI:

  1. Navigate to Management > SSO Providers (/management#sso).
  2. Locate the Vercel provider.
  3. Click Configure to open the settings modal.
  4. Choose Authentication Modes:
    • OAuth Mode: Enable this to allow users to sign in with their Vercel accounts. This requires a Client ID and Client Secret from your Vercel Integration settings.
    • PAT Mode: Enable this to allow users to connect via Personal Access Tokens.
  5. Callback URL: When creating your Vercel Integration, use the following callback URL: https://[your-ideon-domain]/api/vercel/callback

Using the Vercel Block

Add a Vercel block to your canvas using the Create Block menu (Ctrl+A).

  • Project Selection: Search and select any project from your Vercel account.
  • Monitoring: View the current deployment status (Ready, Error, Building), production URL, and recent activity.
  • Actions:
    • Redeploy: Trigger a new deployment from the latest commit directly from the block footer.
    • Streaming Logs: Open a real-time terminal view of deployment logs. Supports Pause/Resume to freeze the stream and Copy to Clipboard.
    • Environment Variables: Add, view, and delete project-level environment variables without leaving Ideon.
    • Active Previews: View a list of all active preview deployments, categorized by branch, with direct links to each.
    • Domains & DNS: Check the verification status of your domains and get precise DNS configuration details (A records, Nameservers) if misconfigured.
    • Bypass Protection: If Vercel Deployment Protection is enabled, you can generate a 24-hour bypass link directly from the block for quick sharing.

Obsidian Import

Ideon supports migrating your knowledge from Obsidian to its spatial canvas.

Importing a Vault

You can import an Obsidian vault by dragging a .zip file of the vault onto the Ideon canvas.

[!IMPORTANT] For the import to succeed, the ZIP file must contain a .obsidian folder. The location of this folder is used to identify the root of the vault.

  • Note Conversion: Obsidian .md files are converted into Note blocks.
  • Bi-directional Links: Wiki-links ([[Internal Link]]) are preserved and mapped to Ideon connections.
  • Folder Structure: The vault's directory structure is preserved using Folder blocks.

Git Providers

Ideon integrates with major Git hosting services to display repository metadata and activity.

Supported Providers

  • GitHub
  • GitLab
  • Gitea
  • Forgejo

Authentication

For private repositories or self-hosted instances:

  1. Go to Account Settings.
  2. Add a Git Token for the respective provider.
  3. Ideon will use this token to securely fetch repository data.

Features

  • Live Activity: Star counts, latest releases, and last commit timestamps.
  • Issue Tracking: Monitor open issues and contributor activity.
  • Visual Mapping: Connect Git blocks to other related notes or design assets on your canvas.