port-labs · sivanel97 · Aug 24, 2025 · Jul 14, 2025 · Jul 14, 2025 · Jul 14, 2025
diff --git a/.../sync-data-to-catalog/git/github-ocean/_github_exporter_supported_resources.mdx b/.../sync-data-to-catalog/git/github-ocean/_github_exporter_supported_resources.mdx
@@ -1,6 +1,10 @@
 - [`repository`](https://docs.github.com/en/rest/repos/repos#get-a-repository)
 - [`pull-request`](https://docs.github.com/en/rest/pulls/pulls#get-a-pull-request)
 - [`file`](/build-your-software-catalog/sync-data-to-catalog/git/github/#ingest-files-from-your-repositories)
+- [`issue`](https://docs.github.com/en/rest/issues/issues#get-an-issue)
+- [`folder`](https://docs.github.com/en/rest/git/trees#get-a-tree)
+- [`user`](https://docs.github.com/en/rest/users/users#get-a-user)
+- [`team`](https://docs.github.com/en/rest/teams/teams#get-a-team-by-name)
 - [`workflow`](https://docs.github.com/en/rest/actions/workflows#get-a-workflow)
 - [`workflow-run`](https://docs.github.com/en/rest/actions/workflow-runs#get-a-workflow-run)
 - [`dependabot-alert`](https://docs.github.com/en/rest/dependabot/alerts#list-dependabot-alerts-for-a-repository)

diff --git a/...-catalog/git/github-ocean/examples/_github_exporter_example_port_app_config.mdx b/...-catalog/git/github-ocean/examples/_github_exporter_example_port_app_config.mdx
@@ -1,6 +1,6 @@
 <details>
 
-<summary><b> Port port-app-config.yml (click to expand)</b></summary>
+<summary><b>Port port-app-config.yml (click to expand)</b></summary>
 
 ```yaml showLineNumbers
 resources:

diff --git a/...mple-deployments-environments/_github_exporter_example_deployment_blueprint.mdx b/...mple-deployments-environments/_github_exporter_example_deployment_blueprint.mdx
@@ -1,5 +1,5 @@
 <details>
-<summary><b>Deployment blueprint (click to expand) </b></summary>
+<summary><b>Deployment blueprint (click to expand)</b></summary>
 
 ```json showLineNumbers
 {

diff --git a/...catalog/git/github-ocean/examples/example-file-kind/_example_file_blueprint.mdx b/...catalog/git/github-ocean/examples/example-file-kind/_example_file_blueprint.mdx
@@ -1,5 +1,5 @@
 <details>
-  <summary>File Blueprint </summary>
+  <summary><b>File Blueprint (click to expand)</b></summary>
 
   ```yaml showLineNumbers
 {

diff --git a/...alog/git/github-ocean/examples/example-file-kind/_example_package_blueprint.mdx b/...alog/git/github-ocean/examples/example-file-kind/_example_package_blueprint.mdx
@@ -1,5 +1,5 @@
 <details>
-<summary>Package blueprint</summary>
+<summary><b>Package blueprint (click to expand)</b></summary>
 
 ```json showLineNumbers
 {

diff --git a/...o-catalog/git/github-ocean/examples/example-file-kind/_file_repo_app_config.mdx b/...o-catalog/git/github-ocean/examples/example-file-kind/_file_repo_app_config.mdx
@@ -1,5 +1,5 @@
 <details>
-  <summary>Port app config </summary>
+  <summary><b>Port app config (click to expand)</b></summary>
 
   ```yaml showLineNumbers
 deleteDependentEntities: true

diff --git a/...atalog/git/github-ocean/examples/example-file-kind/_package_json_app_config.mdx b/...atalog/git/github-ocean/examples/example-file-kind/_package_json_app_config.mdx
@@ -1,6 +1,6 @@
 <details>
 
-<summary>Port config YAML</summary>
+<summary><b>Port config YAML (click to expand)</b></summary>
 
 ```yaml showLineNumbers
  - kind: file

diff --git a/...t/github-ocean/examples/example-issue/_git_exporter_example_issue_blueprint.mdx b/...t/github-ocean/examples/example-issue/_git_exporter_example_issue_blueprint.mdx
@@ -0,0 +1,76 @@
+<details>
+<summary><b>Issue blueprint (click to expand)</b></summary>
+
+```json showLineNumbers
+{
+  "identifier": "githubIssue",
+  "title": "Issue",
+  "icon": "Github",
+  "schema": {
+    "properties": {
+      "creator": {
+        "title": "Creator",
+        "type": "string"
+      },
+      "assignees": {
+        "title": "Assignees",
+        "type": "array"
+      },
+      "labels": {
+        "title": "Labels",
+        "type": "array"
+      },
+      "status": {
+        "title": "Status",
+        "type": "string",
+        "enum": ["open", "closed"],
+        "enumColors": {
+          "open": "green",
+          "closed": "purple"
+        }
+      },
+      "createdAt": {
+        "title": "Created At",
+        "type": "string",
+        "format": "date-time"
+      },
+      "closedAt": {
+        "title": "Closed At",
+        "type": "string",
+        "format": "date-time"
+      },
+      "updatedAt": {
+        "title": "Updated At",
+        "type": "string",
+        "format": "date-time"
+      },
+      "description": {
+        "title": "Description",
+        "type": "string",
+        "format": "markdown"
+      },
+      "issueNumber": {
+        "title": "Issue Number",
+        "type": "number"
+      },
+      "link": {
+        "title": "Link",
+        "type": "string",
+        "format": "url"
+      }
+    },
+    "required": []
+  },
+  "mirrorProperties": {},
+  "calculationProperties": {},
+  "relations": {
+    "repository": {
+      "target": "githubRepository",
+      "required": true,
+      "many": false
+    }
+  }
+}
+```
+
+</details>
diff --git a/...ocean/examples/example-issue/_github_exporter_example_issue_port_app_config.mdx b/...ocean/examples/example-issue/_github_exporter_example_issue_port_app_config.mdx
@@ -0,0 +1,45 @@
+<details>
+
+<summary><b>Port port-app-config.yml (click to expand)</b></summary>
+
+```yaml showLineNumbers
+resources:
+  - kind: repository
+    selector:
+      query: "true" # JQ boolean query. If evaluated to false - skip syncing the object.
+    port:
+      entity:
+        mappings:
+          identifier: ".name" # The Entity identifier will be the repository name.
+          title: ".name"
+          blueprint: '"githubRepository"'
+          properties:
+            readme: file://README.md
+            url: .html_url
+            defaultBranch: .default_branch
+  - kind: issue
+    selector:
+      query: ".pull_request == null" # JQ boolean query. If evaluated to false - skip syncing the object.
+      state: "closed"
+    port:
+      entity:
+        mappings:
+          identifier: ".__repository + (.id|tostring)"
+          title: ".title"
+          blueprint: '"githubIssue"'
+          properties:
+            creator: ".user.login"
+            assignees: "[.assignees[].login]"
+            labels: "[.labels[].name]"
+            status: ".state"
+            createdAt: ".created_at"
+            closedAt: ".closed_at"
+            updatedAt: ".updated_at"
+            description: ".body"
+            issueNumber: ".number"
+            link: ".html_url"
+          relations:
+            repository: ".__repository"
+```
+
+</details>
diff --git a/...examples/example-monorepo/_github_exporter_example_monorepo_port_app_config.mdx b/...examples/example-monorepo/_github_exporter_example_monorepo_port_app_config.mdx
@@ -0,0 +1,27 @@
+<details>
+
+<summary><b>Port port-app-config.yml (click to expand)</b></summary>
+
+```yaml showLineNumbers
+resources:
+  - kind: folder
+    selector:
+      query: "true" # JQ boolean query. If evaluated to false - skip syncing the object.
+      folders: # Specify the repositories and folders to include under this relative path.
+        - path: apps/* # Relative path to the folders within the repositories.
+          repos: # List of repositories to include folders from.
+            - name: backend-service
+              branch: main
+            - name: frontend-service # if you don't specify a branch, we'll use the repository's default branch
+    port:
+      entity:
+        mappings:
+          identifier: .folder.path | split("/") | last
+          title: .folder.path | split("/") | last
+          blueprint: '"githubRepository"'
+          properties:
+            url: .__repository.html_url + "/tree/" + .__repository.default_branch  + "/" + .folder.path
+            readme: file://README.md
+```
+
+</details>
diff --git a/...ory-admins/_github_export_example_repository_with_admins_relation_blueprint.mdx b/...ory-admins/_github_export_example_repository_with_admins_relation_blueprint.mdx
@@ -0,0 +1,38 @@
+<details>
+<summary><b>Repository blueprint (click to expand)</b></summary>
+
+```json showLineNumbers
+{
+  "identifier": "githubRepository",
+  "title": "Repository",
+  "icon": "Microservice",
+  "schema": {
+    "properties": {
+      "readme": {
+        "title": "README",
+        "type": "string",
+        "format": "markdown"
+      },
+      "url": {
+        "title": "Repository URL",
+        "type": "string",
+        "format": "url"
+      }
+    },
+    "required": []
+  },
+  "mirrorProperties": {},
+  "calculationProperties": {},
+  "aggregationProperties": {},
+  "relations": {
+    "admins": {
+      "title": "Admins",
+      "target": "githubUser",
+      "required": false,
+      "many": true
+    }
+  }
+}
+```
+
+</details>
diff --git a/...ple-repository-admins/_github_exporter_example_admins_users_port_app_config.mdx b/...ple-repository-admins/_github_exporter_example_admins_users_port_app_config.mdx
@@ -0,0 +1,48 @@
+<details>
+
+<summary><b> Port port-app-config.yml (click to expand)</b></summary>
+
+```yaml showLineNumbers
+createMissingRelatedEntities: true
+resources:
+  - kind: repository
+    selector:
+      query: "true"
+      include: "collaborators"
+    port:
+      entity:
+        mappings:
+          identifier: .name
+          title: .name
+          blueprint: '"githubRepository"'
+          properties:
+            readme: file://README.md
+            url: .html_url
+            defaultBranch: .default_branch
+          relations:
+            admins: "[.__collaborators[] | select(.is_admin == true) | .login]"
+  - kind: user
+    selector:
+      query: "true"
+    port:
+      entity:
+        mappings:
+          identifier: .login
+          title: if (.name != "" and .name) then .name else .login end
+          blueprint: '"githubUser"'
+          relations:
+            user: .email
+  - kind: user
+    selector:
+      query: "true"
+    port:
+      entity:
+        mappings:
+          identifier: .email
+          title: .email
+          blueprint: '"user"'
+          properties:
+            email: .email
+```
+
+</details>
diff --git a/...s/example-repository-admins/_github_exporter_example_github_users_blueprint.mdx b/...s/example-repository-admins/_github_exporter_example_github_users_blueprint.mdx
@@ -0,0 +1,32 @@
+<details>
+<summary><b>Github Users blueprint (click to expand)</b></summary>
+
+```json showLineNumbers
+{
+  "identifier": "githubUser",
+  "title": "Github User",
+  "icon": "Microservice",
+  "schema": {
+    "properties": {
+      "email": {
+         "title": "Email",
+         "type": "string"
+      }
+    },
+    "required": []
+  },
+  "mirrorProperties": {},
+  "calculationProperties": {},
+  "aggregationProperties": {},
+  "relations": {
+    "user": {
+      "title": "User",
+      "target": "user",
+      "required": false,
+      "many": false
+    }
+  }
+}
+```
+
+</details>
diff --git a/...examples/example-repository-admins/_github_exporter_example_users_blueprint.mdx b/...examples/example-repository-admins/_github_exporter_example_users_blueprint.mdx
@@ -0,0 +1,25 @@
+<details>
+<summary><b>Users blueprint (click to expand)</b></summary>
+
+```json showLineNumbers
+{
+  "identifier": "user",
+  "title": "user",
+  "icon": "Microservice",
+  "schema": {
+    "properties": {
+      "email":{
+        "title":"Email",
+        "type": "string"
+      }
+    },
+    "required": []
+  },
+  "mirrorProperties": {},
+  "calculationProperties": {},
+  "aggregationProperties": {},
+  "relations": {}
+}
+```
+
+</details>