From 5e9755ea3cda25fc681f90cbc5a62bd767a14bcb Mon Sep 17 00:00:00 2001
From: Uruk <contact@uruk.dev>
Date: Mon, 22 Sep 2025 02:45:10 +0200
Subject: [PATCH] chore: standardize development environment and cleanup config
 files

Removes IDE-specific configuration files and establishes Bun as the primary package manager.

Updates project documentation to emphasize Bun usage throughout the development workflow and enhances VS Code settings for better TypeScript performance.

Optimizes EAS build configuration with caching strategies and resource allocation improvements.

Cleans up unused imports and improves TypeScript configuration for better development experience.
---
 .claude/settings.local.json                  |  14 --
 .cursor/rules/no-custom-ios-folder-logic.mdc |   7 -
 .github/copilot-instructions.md              |  97 ++++++----
 .gitignore                                   |  74 +++++---
 .vscode/settings.json                        | 178 +++++++++++++++++--
 components/series/SeasonEpisodesCarousel.tsx |   3 +-
 components/series/SeasonPicker.tsx           |   3 +-
 eas.json                                     |  39 ++++
 modules/index.ts                             |   5 +-
 tsconfig.json                                |  12 +-
 10 files changed, 333 insertions(+), 99 deletions(-)
 delete mode 100644 .claude/settings.local.json
 delete mode 100644 .cursor/rules/no-custom-ios-folder-logic.mdc

diff --git a/.claude/settings.local.json b/.claude/settings.local.json
deleted file mode 100644
index 4727881a..00000000
--- a/.claude/settings.local.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(find:*)",
-      "Bash(bun install:*)",
-      "Bash(bunx expo prebuild:*)",
-      "Bash(bunx expo run:*)",
-      "Bash(npx expo prebuild:*)",
-      "Bash(npx expo run:*)",
-      "Bash(xcodebuild:*)"
-    ],
-    "deny": []
-  }
-}
diff --git a/.cursor/rules/no-custom-ios-folder-logic.mdc b/.cursor/rules/no-custom-ios-folder-logic.mdc
deleted file mode 100644
index 9d2c0b84..00000000
--- a/.cursor/rules/no-custom-ios-folder-logic.mdc
+++ /dev/null
@@ -1,7 +0,0 @@
----
-description: Don't write code directly in the ios folder. 
-globs:
-alwaysApply: true
----
-
-We never write code directly in the ios folder. This code is generated by expo plugins.
\ No newline at end of file
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index c15d5500..f2a6524e 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -3,58 +3,93 @@
 ## Project Overview
 
 Streamyfin is a cross-platform Jellyfin video streaming client built with Expo (React Native).  
-It supports mobile (iOS/Android) and TV platforms, and integrates with Jellyfin and Jellyseerr APIs.
+It supports mobile (iOS/Android) and TV platforms, integrates with Jellyfin and Jellyseerr APIs,
+and provides seamless media streaming with offline capabilities and Chromecast support.
 
 ## Main Technologies
 
-- React Native (Expo)
-- TypeScript
-- React Query
-- Jotai (state management)
-- Jellyfin SDK (TypeScript)
-- BiomeJS (code formatting/linting)
-- EAS (Expo Application Services)
-- Shell scripting (for automation)
-- GitHub Actions (CI/CD)
+- **Runtime**: Bun (JavaScript/TypeScript execution)
+- **Framework**: React Native (Expo)
+- **Language**: TypeScript (strict mode)
+- **State Management**: Jotai (global state) + React Query (server state)
+- **API SDK**: Jellyfin SDK (TypeScript)
+- **Navigation**: Expo Router (file-based routing)
+- **Code Quality**: BiomeJS (formatting/linting)
+- **Build Platform**: EAS (Expo Application Services)
+- **CI/CD**: GitHub Actions with Bun
+
+## Package Management
+
+**CRITICAL: ALWAYS use `bun` for all package management operations**
+
+- **NEVER use `npm`, `yarn`, `bunx` or `npx` commands**
+- Use `bun install` instead of `npm install` or `yarn install`
+- Use `bun add <package>` instead of `npm install <package>`
+- Use `bun remove <package>` instead of `npm uninstall <package>`
+- Use `bun run <script>` instead of `npm run <script>`
+- Use `bunx <command>` instead of `npx <command>`
+- For Expo: use `bunx create-expo-app` or `bunx @expo/cli`
 
 ## Code Structure
 
 - `app/` – Main application code (screens, navigation, etc.)
 - `components/` – Reusable UI components
 - `providers/` – Context and API providers (e.g., JellyfinProvider.tsx)
-- `utils/` – Utility functions and atoms
+- `utils/` – Utility functions and Jotai atoms
 - `assets/` – Images and static assets
 - `scripts/` – Automation scripts (Node.js, Bash)
 - `plugins/` – Expo/Metro plugins
-- `README.md` – Project documentation
 
-## Coding Conventions
+## Coding Standards
 
-- Use TypeScript for all new code.
-- Prefer functional React components.
-- Use hooks for state and side effects.
-- Use Jotai for global state.
-- Use React Query for data fetching/caching.
-- Use BiomeJS for formatting and linting.
-- Follow the established folder structure for screens/components.
+- Use TypeScript for ALL files (no .js files)
+- Prefer functional React components with hooks
+- Use Jotai atoms for global state management
+- Use React Query for server state and caching
+- Follow BiomeJS formatting and linting rules
+- Use `const` over `let`, avoid `var` entirely
+- Implement proper error boundaries
+- Use React.memo() for performance optimization
+- Handle both mobile and TV navigation patterns
 
-## API Usage
+## API Integration
 
-- Use the Jellyfin SDK for all server interactions.
-- Use the `apiAtom` and `userAtom` from `JellyfinProvider` for authenticated API calls.
-- For navigation, use `expo-router`.
+- Use Jellyfin SDK for all server interactions
+- Access authenticated APIs via `apiAtom` and `userAtom` from JellyfinProvider
+- Implement proper loading states and error handling
+- Use React Query for caching and background updates
+- Handle offline scenarios gracefully
+
+## Performance Optimization
+
+- Leverage Bun's superior runtime performance
+- Optimize FlatList components with proper props
+- Use lazy loading for non-critical components
+- Implement proper image caching strategies
+- Monitor bundle size and use tree-shaking effectively
+
+## Testing
+
+- Use Bun's built-in test runner when possible
+- Test files: `*.test.ts` or `*.test.tsx`
+- Run tests with: `bun test`
+- Mock external APIs in tests
+- Focus on testing business logic and custom hooks
 
 ## Commit Messages
 
-- Use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) (e.g., `feat:`, `fix:`, `chore:`).
-- Example: `feat(player): add Chromecast support`
+Use [Conventional Commits](https://www.conventionalcommits.org/):
+Exemple:
+- `feat(player): add Chromecast support`
+- `fix(auth): handle expired JWT tokens`
+- `chore(deps): update Jellyfin SDK`
 
 ## Special Instructions
 
-- When suggesting code, prefer using existing atoms, hooks, and utility functions.
-- When adding new features, ensure they are accessible via both mobile and TV navigation if relevant.
-- When updating dependencies or scripts, check for compatibility with Expo and EAS.
-
----
+- Prioritize cross-platform compatibility (mobile + TV)
+- Ensure accessibility for TV remote navigation
+- Use existing atoms, hooks, and utilities before creating new ones
+- Maintain compatibility with Expo and EAS workflows
+- Always verify Bun compatibility when suggesting new dependencies
 
 **Copilot: Please use these instructions to provide context-aware suggestions and code completions for this repository.**
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index b6d9c1a0..f75ba12e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,27 +1,16 @@
+# Dependencies and Package Managers
 node_modules/
-.expo/
-dist/
-npm-debug.*
-*.jks
-*.p8
-*.p12
-*.key
-*.mobileprovision
-*.orig.*
-web-build/
-modules/vlc-player/android/build
-
-# macOS
-.DS_Store
-
-expo-env.d.ts
-
-Streamyfin.app
-
-*.mp4
-Streamyfin.app
+bun.lock
+bun.lockb
 package-lock.json
 
+# Expo and React Native Build Artifacts
+.expo/
+dist/
+web-build/
+.tsbuildinfo
+
+# Platform-specific Build Directories
 /ios
 /android
 /iostv
@@ -29,21 +18,48 @@ package-lock.json
 /androidmobile
 /androidtv
 
+# Module-specific Builds
+modules/vlc-player/android/build
 modules/player/android
+modules/hls-downloader/android/build
 
-pc-api-7079014811501811218-719-3b9f15aeccf8.json
-credentials.json
+# Generated Applications
+Streamyfin.app
 *.apk
 *.ipa
-.continuerc.json
+*.aab
 
+# Certificates and Keys
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Debug and Temporary Files
+npm-debug.*
+*.orig.*
+*.mp4
+
+# OS-specific Files
+# macOS
+.DS_Store
+
+# IDE and Editor Files
 .vscode/
 .idea/
 .ruby-lsp
-modules/hls-downloader/android/build
-streamyfin-4fec1-firebase-adminsdk.json
+
+# Environment and Configuration
+expo-env.d.ts
+.continuerc.json
 .env
 .env.local
-*.aab
-/version-backup-*
-bun.lockb
\ No newline at end of file
+
+# Secrets and Credentials
+pc-api-7079014811501811218-719-3b9f15aeccf8.json
+credentials.json
+streamyfin-4fec1-firebase-adminsdk.json
+
+# Version and Backup Files
+/version-backup-*
\ No newline at end of file
diff --git a/.vscode/settings.json b/.vscode/settings.json
index b200b485..a2045cef 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,24 +1,180 @@
 {
+  // ==========================================
+  // FORMATTING & LINTING
+  // ==========================================
+
+  // Biome as default formatter
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.formatOnSave": true,
+  "editor.formatOnPaste": true,
+  "editor.formatOnType": false,
+
+  // Language-specific formatters
   "[javascript]": {
     "editor.defaultFormatter": "biomejs.biome",
     "editor.formatOnSave": true
   },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
   "[typescriptreact]": {
     "editor.defaultFormatter": "biomejs.biome",
     "editor.formatOnSave": true
   },
-  "prettier.printWidth": 120,
-  "[swift]": {
-    "editor.defaultFormatter": "sswg.swift-lang"
-  },
-  "editor.formatOnSave": true,
-  "editor.defaultFormatter": "biomejs.biome",
-  "[typescript]": {
-    "editor.defaultFormatter": "biomejs.biome",
-    "editor.formatOnSave": true
-  },
   "[javascriptreact]": {
     "editor.defaultFormatter": "biomejs.biome",
     "editor.formatOnSave": true
-  }
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[swift]": {
+    "editor.insertSpaces": true,
+    "editor.tabSize": 2
+  },
+
+  // ==========================================
+  // TYPESCRIPT & JAVASCRIPT
+  // ==========================================
+
+  // TypeScript performance optimizations
+  "typescript.preferences.includePackageJsonAutoImports": "auto",
+  "typescript.suggest.autoImports": true,
+  "typescript.updateImportsOnFileMove.enabled": "always",
+  "typescript.preferences.preferTypeOnlyAutoImports": true,
+  "typescript.preferences.importModuleSpecifier": "relative",
+  "typescript.preferences.includeCompletionsForImportStatements": true,
+  "typescript.preferences.includeCompletionsWithSnippetText": true,
+
+  // JavaScript settings
+  "javascript.preferences.importModuleSpecifier": "relative",
+  "javascript.suggest.autoImports": true,
+  "javascript.updateImportsOnFileMove.enabled": "always",
+
+  // ==========================================
+  // REACT NATIVE & EXPO
+  // ==========================================
+
+  // File associations for React Native
+  "files.associations": {
+    "*.expo.ts": "typescript",
+    "*.expo.tsx": "typescriptreact",
+    "*.expo.js": "javascript",
+    "*.expo.jsx": "javascriptreact",
+    "metro.config.js": "javascript",
+    "babel.config.js": "javascript",
+    "app.config.js": "javascript",
+    "eas.json": "jsonc"
+  },
+
+  // React Native specific settings
+  "emmet.includeLanguages": {
+    "typescriptreact": "html",
+    "javascriptreact": "html"
+  },
+  "emmet.triggerExpansionOnTab": true,
+
+  // Exclude build directories from search
+  "search.exclude": {
+    "**/node_modules": true
+  },
+
+  // ==========================================
+  // EDITOR PERFORMANCE & UX
+  // ==========================================
+
+  // Performance optimizations
+  "editor.largeFileOptimizations": true,
+  "files.watcherExclude": {
+    "**/.git/objects/**": true,
+    "**/.git/subtree-cache/**": true,
+    "**/node_modules/**": true,
+    "**/.expo/**": true,
+    "**/ios/**": true,
+    "**/android/**": true,
+    "**/build/**": true,
+    "**/dist/**": true
+  },
+
+  // Better editor behavior
+  "editor.suggestSelection": "first",
+  "editor.quickSuggestions": {
+    "strings": true,
+    "comments": true,
+    "other": true
+  },
+  "editor.snippetSuggestions": "top",
+  "editor.tabCompletion": "on",
+  "editor.wordBasedSuggestions": "off",
+
+  // ==========================================
+  // TERMINAL & DEVELOPMENT
+  // ==========================================
+
+  // Terminal settings for Bun
+  "terminal.integrated.shell.windows": "C:\\Windows\\System32\\cmd.exe",
+  "terminal.integrated.env.windows": {
+    "PATH": "${env:PATH};./node_modules/.bin"
+  },
+
+  // ==========================================
+  // WORKSPACE & NAVIGATION
+  // ==========================================
+
+  // Better workspace navigation
+  "explorer.fileNesting.enabled": true,
+  "explorer.fileNesting.expand": false,
+  "explorer.fileNesting.patterns": {
+    "*.ts": "${capture}.js",
+    "*.tsx": "${capture}.js",
+    "*.js": "${capture}.js,${capture}.js.map,${capture}.min.js,${capture}.d.ts",
+    "*.jsx": "${capture}.js",
+    "package.json": "package-lock.json,yarn.lock,bun.lock,bun.lockb,.yarnrc,.yarnrc.yml",
+    "tsconfig.json": "tsconfig.*.json",
+    ".env": ".env.*",
+    "app.json": "app.config.js,eas.json,expo-env.d.ts",
+    "README.md": "LICENSE.txt,SECURITY.md,CODE_OF_CONDUCT.md,CONTRIBUTING.md"
+  },
+
+  // Better breadcrumbs and navigation
+  "breadcrumbs.enabled": true,
+  "outline.showVariables": true,
+  "outline.showConstants": true,
+
+  // ==========================================
+  // GIT & VERSION CONTROL
+  // ==========================================
+
+  // Git integration
+  "git.autofetch": true,
+  "git.enableSmartCommit": true,
+  "git.confirmSync": false,
+  "git.ignoreLimitWarning": true,
+
+  // ==========================================
+  // CODE QUALITY & ERRORS
+  // ==========================================
+
+  // Better error detection
+  "typescript.validate.enable": true,
+  "javascript.validate.enable": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "explicit",
+    "source.organizeImports": "explicit"
+  },
+
+  // Problem matcher for better error display
+  "typescript.tsc.autoDetect": "on",
+
+  // ==========================================
+  // LEGACY SETTINGS (keeping for compatibility)
+  // ==========================================
+
+  "prettier.printWidth": 120
 }
diff --git a/components/series/SeasonEpisodesCarousel.tsx b/components/series/SeasonEpisodesCarousel.tsx
index 38047722..e8242872 100644
--- a/components/series/SeasonEpisodesCarousel.tsx
+++ b/components/series/SeasonEpisodesCarousel.tsx
@@ -1,13 +1,12 @@
 import type { BaseItemDto } from "@jellyfin/sdk/lib/generated-client/models";
 import { getTvShowsApi } from "@jellyfin/sdk/lib/utils/api";
-import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useQuery } from "@tanstack/react-query";
 import { router } from "expo-router";
 import { useAtom } from "jotai";
 import { useEffect, useMemo, useRef } from "react";
 import { TouchableOpacity, type ViewProps } from "react-native";
 import { useDownload } from "@/providers/DownloadProvider";
 import { apiAtom, userAtom } from "@/providers/JellyfinProvider";
-import { getUserItemData } from "@/utils/jellyfin/user-library/getUserItemData";
 import ContinueWatchingPoster from "../ContinueWatchingPoster";
 import {
   HorizontalScroll,
diff --git a/components/series/SeasonPicker.tsx b/components/series/SeasonPicker.tsx
index 3d7ba5fa..1559e2c5 100644
--- a/components/series/SeasonPicker.tsx
+++ b/components/series/SeasonPicker.tsx
@@ -11,7 +11,6 @@ import {
   type SeasonIndexState,
 } from "@/components/series/SeasonDropdown";
 import { apiAtom, userAtom } from "@/providers/JellyfinProvider";
-import { getUserItemData } from "@/utils/jellyfin/user-library/getUserItemData";
 import { runtimeTicksToSeconds } from "@/utils/time";
 import ContinueWatchingPoster from "../ContinueWatchingPoster";
 import { Text } from "../common/Text";
@@ -101,7 +100,7 @@ export const SeasonPicker: React.FC<Props> = ({ item }) => {
     enabled: !!api && !!user?.Id && !!item.Id && !!selectedSeasonId,
   });
 
-  const queryClient = useQueryClient();
+  const _queryClient = useQueryClient();
 
   // Used for height calculation
   const [nrOfEpisodes, setNrOfEpisodes] = useState(0);
diff --git a/eas.json b/eas.json
index 9173f4ea..e37611fd 100644
--- a/eas.json
+++ b/eas.json
@@ -4,6 +4,11 @@
   },
   "build": {
     "development": {
+      "resourceClass": "medium",
+      "cache": {
+        "key": "development-{{ checksum \"bun.lock\" }}-{{ checksum \"package.json\" }}",
+        "paths": ["~/.bun/install/cache", "node_modules", ".expo"]
+      },
       "environment": "development",
       "developmentClient": true,
       "distribution": "internal",
@@ -15,6 +20,11 @@
       }
     },
     "development_tv": {
+      "resourceClass": "medium",
+      "cache": {
+        "key": "development-tv-{{ checksum \"bun.lock\" }}-{{ checksum \"package.json\" }}",
+        "paths": ["~/.bun/install/cache", "node_modules", ".expo"]
+      },
       "environment": "development",
       "developmentClient": true,
       "distribution": "internal",
@@ -27,6 +37,11 @@
       }
     },
     "development-simulator": {
+      "resourceClass": "medium",
+      "cache": {
+        "key": "development-simulator-{{ checksum \"bun.lock\" }}-{{ checksum \"package.json\" }}",
+        "paths": ["~/.bun/install/cache", "node_modules", ".expo"]
+      },
       "environment": "development",
       "developmentClient": true,
       "distribution": "internal",
@@ -38,19 +53,38 @@
       }
     },
     "preview": {
+      "resourceClass": "large",
+      "cache": {
+        "key": "preview-{{ checksum \"bun.lock\" }}-{{ checksum \"package.json\" }}",
+        "paths": ["~/.bun/install/cache", "node_modules", ".expo"]
+      },
       "distribution": "internal",
       "env": {
         "EXPO_PUBLIC_WRITE_DEBUG": "1"
       }
     },
     "production": {
+      "resourceClass": "large",
+      "cache": {
+        "key": "production-{{ checksum \"bun.lock\" }}-{{ checksum \"package.json\" }}",
+        "paths": ["~/.bun/install/cache", "node_modules", ".expo"]
+      },
       "environment": "production",
       "channel": "0.36.0",
       "android": {
+        "buildType": "aab",
+        "image": "latest"
+      },
+      "ios": {
         "image": "latest"
       }
     },
     "production-apk": {
+      "resourceClass": "large",
+      "cache": {
+        "key": "production-apk-{{ checksum \"bun.lock\" }}-{{ checksum \"package.json\" }}",
+        "paths": ["~/.bun/install/cache", "node_modules", ".expo"]
+      },
       "environment": "production",
       "channel": "0.36.0",
       "android": {
@@ -59,6 +93,11 @@
       }
     },
     "production-apk-tv": {
+      "resourceClass": "large",
+      "cache": {
+        "key": "production-apk-tv-{{ checksum \"bun.lock\" }}-{{ checksum \"package.json\" }}",
+        "paths": ["~/.bun/install/cache", "node_modules", ".expo"]
+      },
       "environment": "production",
       "channel": "0.36.0",
       "android": {
diff --git a/modules/index.ts b/modules/index.ts
index 63eb373e..949c40f4 100644
--- a/modules/index.ts
+++ b/modules/index.ts
@@ -12,8 +12,9 @@ import {
 } from "./VlcPlayer.types";
 import VlcPlayerView from "./VlcPlayerView";
 
-export {
-  VlcPlayerView,
+export { VlcPlayerView };
+
+export type {
   VlcPlayerViewProps,
   VlcPlayerViewRef,
   PlaybackStatePayload,
diff --git a/tsconfig.json b/tsconfig.json
index e6cb7ef4..69354e8d 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -6,7 +6,17 @@
     "jsxImportSource": "react",
     "paths": {
       "@/*": ["./*"]
-    }
+    },
+    "incremental": true,
+    "tsBuildInfoFile": ".tsbuildinfo",
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
   },
   "include": [
     "app/**/*",