docs: add gh-pages

.github/workflows/documentation.yml

@@ -0,0 +1,51 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - docs/**
+  pull_request:
+    branches: [main]
+    paths:
+      - docs/**
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: pnpm
+
+      - name: Install & build
+        working-directory: docs
+        run: |
+          pnpm i
+          pnpm build
+
+      # Popular action to deploy to GitHub Pages:
+      # Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          # Build output to publish to the `gh-pages` branch:
+          publish_dir: ./docs/build
+          # Assign commit authorship to the official GH-Actions bot
+          user_name: github-actions[bot]
+          user_email: github-actions[bot]@users.noreply.github.com

.github/workflows/release.yml

@@ -7,6 +7,8 @@ on:
       - "main"
     tags:
       - "v*.*.*"
+    paths-ignore:
+      - "docs/**"
 
 permissions:
   contents: read

.prettierignore

@@ -1 +1,2 @@
 pnpm-lock.yaml
+docs/build

README.md

@@ -1,5 +1,8 @@
 # Configarr
 
+[![GitHub License](https://img.shields.io/github/license/raydak-labs/configarr)](https://github.com/recyclarr/recyclarr/blob/master/LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/raydak-labs/configarr?logo=github)](https://github.com/raydak-labs/configarr/releases/)
+
 Configuration and synchronization tool for Sonarr and Radarr.
 
 Official support only for Sonarr v4 and radarr v5.
@@ -43,50 +46,6 @@ See [here](./custom/cfs/)
   - See here: https://github.com/PCJones/radarr-sonarr-german-dual-language
   - Or good german guide: https://github.com/PCJones/usenet-guide
 
-### How to add own CustomFormats
-
-- You have two ways to provide own custom formats:
-
-  - `As file`
-    - Export from Sonarr/Radarr instance UI (in the CustomFormats list you have two icons for each custom format: clone and export)
-    - Or use existing custom formats from recyclarr or trash guide
-  - `As yaml`: You can also directly implement the custom format in the config.
-    It follows the same keys as the JSON format.
-
-    ```yaml
-    # config.yml
-    customFormatDefinitions:
-      - trash_id: custom-de-only
-        trash_scores:
-          default: -10000
-        trash_description: "Language: German Only"
-        name: "Language: Not German"
-        includeCustomFormatWhenRenaming: false
-        specifications:
-          - name: Not German Language
-            implementation: LanguageSpecification
-            negate: true
-            required: false
-            fields:
-              value: 4
-    ```
-
-- What you have to add at least is to the field `trash_id` or `configarr_id` to the JSON/YAML.
-  The ID can be anything you like but should not conflict with other CustomFormats.
-  Otherwise those will be overwritten during merge process.
-
-```json
-{
-  "configarr_id": "your_own_id",
-  ...other content from export
-}
-```
-
-- Add it as custom format location in your `config.yml`
-- After adding the ID you can simply reference it in the `config.yml` to add it to the QualityProfiles. `localCustomFormatsPath: /your/path/cfs`
-
-> :scroll: You can see an example here [Examples / Full](./examples/full/cfs/custom-size-bigger-40gb.json). Or copy the existing custom formats [custom](./custom/cfs/) in your location.
-
 ## Development
 
 1. Optionally setup the local sonarr instance
@@ -105,124 +64,3 @@ See [here](./custom/cfs/)
 ## Examples
 
 Some examples for configuration are provided [Examples](./examples/)
-
-## How to run
-
-Required files:
-
-- `config.yml`
-- `secrets.yml`
-
-Optional:
-
-- Custom Formats in folders
-
-### Docker
-
-`docker run --rm -v ./:/app/config ghcr.io/raydak-labs/configarr:latest`
-
-### Docker-compose
-
-```yml
-services:
-  configarr:
-    image: ghcr.io/raydak-labs/configarr:latest
-
-    volumes:
-      - ./config:/app/config # Contains the config.yml and secrets.yml
-      - ./dockerrepos:/app/repos # Cache repositories
-      - ./custom/cfs:/app/cfs # Optional if custom formats locally provided
-      - ./custom/templates:/app/templates # Optional if custom templates
-```
-
-### Kubernetes
-
-Example how to run `CronJob` which will regulary sync your configs.
-
-```yml
----
-apiVersion: batch/v1
-kind: CronJob
-metadata:
-  name: configarr
-spec:
-  schedule: "0 * * * *"
-  successfulJobsHistoryLimit: 1
-  failedJobsHistoryLimit: 1
-  jobTemplate:
-    spec:
-      template:
-        spec:
-          containers:
-            - name: configarr
-              image: ghcr.io/raydak-labs/configarr:latest
-              imagePullPolicy: Always
-              tty: true # for color support
-              envFrom:
-                - configMapRef:
-                    name: common-deployment-environment
-              volumeMounts:
-                - mountPath: /app/repos # Cache repositories
-                  name: app-data
-                  subPath: configarr-repos
-                - name: config-volume # Mount specifc config
-                  mountPath: /app/config/config.yml
-                  subPath: config.yml
-                - name: secret-volume
-                  mountPath: /app/config/secrets.yml # Mount secrets
-                  subPath: secrets.yml
-          volumes:
-            - name: app-data
-              persistentVolumeClaim:
-                claimName: media-app-data
-            - name: config-volume
-              configMap:
-                name: configarr
-            - name: secret-volume
-              secret:
-                secretName: configarr
-          restartPolicy: Never
----
-apiVersion: v1
-kind: Secret
-metadata:
-  name: configarr
-type: Opaque
-stringData:
-  secrets.yml: |
-    SONARR_API_KEY: "{{ configarr.sonarrApiKey }}"
----
-apiVersion: v1
-kind: ConfigMap
-metadata:
-  name: configarr
-data:
-  config.yml: |
-    trashGuideUrl: https://github.com/TRaSH-Guides/Guides
-    recyclarrConfigUrl: https://github.com/recyclarr/config-templates
-
-    sonarr:
-      series:
-        # Set the URL/API Key to your actual instance
-        base_url: http://sonarr:8989
-        api_key: !secret SONARR_API_KEY
-
-        # Quality definitions from the guide to sync to Sonarr. Choices: series, anime
-        quality_definition:
-          type: series
-
-        include:
-          # Comment out any of the following includes to disable them
-          #### WEB-1080p
-          - template: sonarr-quality-definition-series
-          - template: sonarr-v4-quality-profile-web-1080p
-          - template: sonarr-v4-custom-formats-web-1080p
-
-          #### WEB-2160p
-          - template: sonarr-v4-quality-profile-web-2160p
-          - template: sonarr-v4-custom-formats-web-2160p
-
-        # Custom Formats: https://recyclarr.dev/wiki/yaml/config-reference/custom-formats/
-        custom_formats: []
-    radarr: {}
-```

docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs/README.md

@@ -0,0 +1,41 @@
+# Configarr documentation
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ pnpm
+```
+
+### Local Development
+
+```
+$ pnpm start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```
+$ pnpm build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+Using SSH:
+
+```
+$ USE_SSH=true pnpm deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> pnpm deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

docs/docs/concepts.md

@@ -0,0 +1,59 @@
+---
+sidebar_position: 2
+description: "Basic concepts and terminology for understanding Sonarr, Radarr, and custom formats"
+keywords: [sonarr, radarr, custom formats, quality profiles, media management, automation]
+---
+
+# What are Arr Applications?
+
+This page explains the fundamental concepts and components that Configarr works with. Understanding these will help you make the most of the tool.
+
+## Media Managers
+
+### Sonarr
+
+[Sonarr](https://sonarr.tv/) is a TV series management tool that automates the downloading and organizing of TV shows. It can monitor multiple RSS feeds for new episodes and will grab, sort, and rename them.
+
+### Radarr
+
+[Radarr](https://radarr.video/) is a movie collection manager that works similarly to Sonarr but focuses on movies instead of TV series. It's designed to automatically download and organize movie files.
+
+## Key Terminology
+
+### Custom Formats
+
+Custom formats are rules that help Sonarr and Radarr identify and prioritize specific characteristics of media files. These can include:
+
+- Video quality (HDR, DV, etc.)
+- Audio formats (DTS, TrueHD, etc.)
+- Release groups
+- Language specifications
+- Encoding settings
+
+### Quality Profiles
+
+Quality profiles define what types of releases you want for your media. They combine:
+
+- Allowed quality types (1080p, 2160p, etc.)
+- Custom format scores
+- Upgrade rules
+- Minimum/maximum size requirements
+
+### Release Groups
+
+Release groups are teams or individuals who release media content. Different groups often have different standards and specialties for their releases.
+
+### TRaSH Guides
+
+[TRaSH Guides](https://trash-guides.info/) is a comprehensive collection of guides and configurations for various media management tools. It provides recommended settings, custom formats, and quality profiles that represent community best practices.
+
+## How They Work Together
+
+- **Quality Profiles** use **Custom Formats** to score and select releases
+- **Sonarr/Radarr** use these profiles to make download decisions
+- **TRaSH Guides** provides optimized configurations for both
+- **Configarr** helps manage and synchronize all these components
+
+:::tip
+For detailed setup instructions and tutorials, visit the official documentation for [Sonarr](https://wiki.servarr.com/sonarr) and [Radarr](https://wiki.servarr.com/radarr).
+:::

docs/docs/configuration/_category_.json

@@ -0,0 +1,7 @@
+{
+  "label": "Configuration",
+  "position": 3,
+  "link": {
+    "type": "generated-index"
+  }
+}