docs(integration): add ical (#404)

Author: NicolasNewman

docs/integrations/ical/index.mdx

@@ -0,0 +1,38 @@
+---
+title: 'iCal'
+description: "iCal is a standard for calendar data exchange, allowing users to share and manage calendar events across different platforms."
+hide_title: true
+---
+
+import { IntegrationHeader } from '@site/src/components/integrations/header';
+import { IntegrationCapabilites } from '@site/src/components/integrations/widgets';
+import { AddingIntegration } from '@site/src/components/integrations/adding';
+import {IntegrationSecrets} from '@site/src/components/integrations/secrets';
+import { IconZoomQuestion, IconChartBar, IconSearch } from "@tabler/icons-react";
+import { icalIntegration } from '.';
+import { calendarWidget } from '@site/docs/widgets/calendar';
+
+<IntegrationHeader
+  integration={icalIntegration}
+  categories={['Calendar']}
+/>
+
+### Widgets & Capabilities
+<IntegrationCapabilites
+    items={[{
+      widget: calendarWidget
+    }]}
+/>
+
+### Adding the integration
+<AddingIntegration />
+
+### Secrets
+<IntegrationSecrets secrets={[{
+    credentials: ['url'],
+    steps: []
+}]} />
+
+## Using the iCal integration
+
+The iCal integration allows you to add external calendars to Homarr. Any calendar that provides a public iCal URL can be integrated, such as Google Calendar, Apple Calendar, or Outlook.

docs/integrations/ical/index.ts

@@ -0,0 +1,9 @@
+import { IntegrationDefinition } from '@site/src/types';
+
+export const icalIntegration: IntegrationDefinition = {
+  name: 'iCal',
+  description:
+    'iCal is a standard for calendar data exchange, allowing users to share and manage calendar events across different platforms.',
+  iconUrl: 'https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/ical.svg',
+  path: '../../integrations/ical',
+};

docs/widgets/calendar/index.mdx

@@ -17,6 +17,7 @@ import { nextcloudIntegration } from '@site/docs/integrations/nextcloud';
 import { radarrIntegration } from '@site/docs/integrations/radarr';
 import { readarrIntegration } from '@site/docs/integrations/readarr';
 import { sonarrIntegration } from '@site/docs/integrations/sonarr';
+import { icalIntegration } from '@site/docs/integrations/ical';
 
 
 <WidgetHeader
@@ -53,6 +54,8 @@ import withoutIntegrations from './img/without-integrations.png';
   integration: readarrIntegration,
 }, {
   integration: sonarrIntegration,
+}, {
+  integration: icalIntegration
 }]} />
 
 ### Interactions

src/components/integrations/secrets.tsx

@@ -2,6 +2,7 @@ import {
   IconCode,
   IconKey,
   IconKeyOff,
+  IconLink,
   IconPassword,
   IconPlug,
   IconUser,
@@ -65,6 +66,11 @@ const secretKinds = {
     description: 'The private key for authentication',
     icon: IconKey,
   },
+  url: {
+    name: 'Url',
+    description: 'The url of the service',
+    icon: IconLink,
+  },
 };
 
 type SecretKind = keyof typeof secretKinds;

src/constants/supported-integrations.tsx

@@ -22,4 +22,5 @@ export const supportedIntegrations = [
   { iconUrl: 'https://cdn.jsdelivr.net/gh/loganmarchione/homelab-svg-assets/assets/adguardhome.svg', name: 'AdguardHome' },
   { iconUrl: 'https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/png/tdarr.png', name: 'Tdarr' },
   { iconUrl: 'https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/svg/prowlarr.svg', name: 'Prowlarr' },
+  { iconUrl: 'https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/svg/ical.svg', name: 'iCal' },
 ];