Added Docker

Author: ablomer

.dockerignore

@@ -0,0 +1,13 @@
+.git
+node_modules
+npm-debug.log
+Dockerfile
+.dockerignore
+.env
+*.md
+.eslintrc*
+dist
+coverage
+.vscode
+data/
+history.json 

.gitignore

@@ -25,5 +25,5 @@ dist-ssr
 
 docs/
 
-config.json
-history.json
+# Data directory
+data/

Dockerfile

@@ -0,0 +1,42 @@
+# Build stage
+FROM node:20-slim AS builder
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN npm run build
+
+# Production stage
+FROM node:20-slim AS production
+
+WORKDIR /app
+
+# Copy package files and install production dependencies
+COPY package*.json ./
+RUN npm ci --production
+
+# Copy built files from builder
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/src ./src
+
+# Create data directory and ensure it exists
+RUN mkdir -p /app/data
+
+# Expose the port the app runs on
+EXPOSE 3000
+
+# Set environment variables
+ENV NODE_ENV=production
+ENV RSS_WATCHER_DATA_DIR=/app/data
+
+# Start the application
+CMD ["npm", "start"]

README.md

@@ -1,50 +1,104 @@
-# React + TypeScript + Vite
+# RSS Watcher
 
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+A modern web application for monitoring RSS feeds and receiving notifications when new posts match your keywords. Built with React, Express, and TypeScript.
 
-Currently, two official plugins are available:
+## Features
 
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+- 🔍 Monitor multiple RSS feeds simultaneously
+- 🔑 Define custom keywords for each feed
+- 🔔 Real-time notifications via [ntfy.sh](https://ntfy.sh)
+- ⏰ Configurable check intervals
+- 📱 Responsive web interface
+- 📜 Detailed feed history tracking
+- 🚦 Live feed status monitoring
 
-## Expanding the ESLint configuration
+## Getting Started
 
-If you are developing a production application, we recommend updating the configuration to enable type aware lint rules:
+### Prerequisites
 
-- Configure the top-level `parserOptions` property like this:
+- Node.js (v14 or higher)
+- npm or yarn
 
-```js
-export default tseslint.config({
-  languageOptions: {
-    // other options...
-    parserOptions: {
-      project: ['./tsconfig.node.json', './tsconfig.app.json'],
-      tsconfigRootDir: import.meta.dirname,
-    },
-  },
-})
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/ablomer/rsswatcher.git
+cd rsswatcher
+```
+
+2. Install dependencies:
+```bash
+npm install
+# or
+yarn install
+```
+
+### Development
+
+Run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
 ```
 
-- Replace `tseslint.configs.recommended` to `tseslint.configs.recommendedTypeChecked` or `tseslint.configs.strictTypeChecked`
-- Optionally add `...tseslint.configs.stylisticTypeChecked`
-- Install [eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react) and update the config:
-
-```js
-// eslint.config.js
-import react from 'eslint-plugin-react'
-
-export default tseslint.config({
-  // Set the react version
-  settings: { react: { version: '18.3' } },
-  plugins: {
-    // Add the react plugin
-    react,
-  },
-  rules: {
-    // other rules...
-    // Enable its recommended rules
-    ...react.configs.recommended.rules,
-    ...react.configs['jsx-runtime'].rules,
-  },
-})
+### Production
+
+Build and start the production server:
+
+```bash
+npm run build
+npm start
+# or
+yarn build
+yarn start
 ```
+
+Once the server is running, visit `http://localhost:3000` in your browser to access the web interface.
+
+## Configuration
+
+All configuration is managed through the web interface:
+
+### Feed Management
+- Add, edit, or remove RSS feeds through the "Feeds" tab
+- Set keywords for each feed to monitor
+- View feed status and history
+
+### Settings
+- Configure ntfy.sh notification settings in the "Settings" tab
+  - Set your ntfy topic
+  - Configure ntfy server address (defaults to https://ntfy.sh)
+  - Adjust feed check interval
+
+## Docker Support
+
+Build the Docker image:
+
+```bash
+docker build -t rsswatcher .
+```
+
+Run the container:
+
+```bash
+# Create a directory for persistent data
+mkdir -p data
+
+# Run the container with mounted data directory
+docker run -p 3000:3000 \
+  -v $(pwd)/data:/app/data \
+  rsswatcher
+```
+
+This will persist all application data (configuration and history) across container restarts.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License (see the [LICENSE](LICENSE) file for details).

src/server/config.ts

@@ -1,8 +1,10 @@
 import fs from 'fs';
 import path from 'path';
 import { AppConfig } from './types';
+import { DEFAULT_DATA_DIR } from './constants';
 
-const CONFIG_FILE = path.join(process.cwd(), 'config.json');
+const DATA_DIR = process.env.RSS_WATCHER_DATA_DIR || DEFAULT_DATA_DIR;
+const CONFIG_FILE = path.join(DATA_DIR, 'config.json');
 
 const DEFAULT_CONFIG: AppConfig = {
   feeds: [],
@@ -15,6 +17,10 @@ export class ConfigManager {
   private config: AppConfig;
 
   constructor() {
+    // Ensure data directory exists
+    if (!fs.existsSync(DATA_DIR)) {
+      fs.mkdirSync(DATA_DIR, { recursive: true });
+    }
     this.config = this.loadConfig();
   }
 

src/server/constants.ts

@@ -0,0 +1 @@
+export const DEFAULT_DATA_DIR = '/app/data'; 

src/server/feedMonitor.ts

@@ -78,7 +78,7 @@ export class FeedMonitor {
       });
 
       const matchingItems = newItems.map((item: RssItem) => ({
-        title: item.title || '',
+        title: (item.title || '').trim(),
         link: item.link || '',
         description: item['dc:content'] || item['content:encoded'] || item.content || item.summary || item.contentSnippet || '',
         content: item['dc:content'] || item['content:encoded'] || item.content || '',
@@ -119,7 +119,7 @@ export class FeedMonitor {
           this.postHistoryManager.addCheckedPost(
             item.guid,
             url,
-            item.title || '',
+            (item.title || '').trim(),
             item.link || '',
             matchedKeywords,
             matchedKeywords.length > 0  // notification sent if keywords matched
@@ -151,9 +151,9 @@ export class FeedMonitor {
   private async sendNotification(item: FeedItem) {
     const config = this.configManager.getConfig();
     const ntfyUrl = `${config.ntfyServerAddress}/${config.ntfyTopic}`;
+    // console.log(`Sending notification for ${item.title}`);
 
     try {
-      console.log(`Sending notification for ${item.title}`);
       // Sanitize the title by removing any characters
       // that aren't in the ASCII printable range (0x20 to 0x7E)
       const sanitizedTitle = item.title.replace(/[^\x20-\x7E]/g, '');

src/server/postHistory.ts

@@ -1,22 +1,26 @@
 import fs from 'fs';
 import path from 'path';
 import { PostHistory, FeedHistoryEntry } from './types';
+import { DEFAULT_DATA_DIR } from './constants';
 
-const POST_HISTORY_FILE = 'history.json';
+const DATA_DIR = process.env.RSS_WATCHER_DATA_DIR || DEFAULT_DATA_DIR;
+const POST_HISTORY_FILE = path.join(DATA_DIR, 'history.json');
 
 export class PostHistoryManager {
     private history: PostHistory = {};
-    private filePath: string;
 
     constructor() {
-        this.filePath = path.join(process.cwd(), POST_HISTORY_FILE);
+        // Ensure data directory exists
+        if (!fs.existsSync(DATA_DIR)) {
+            fs.mkdirSync(DATA_DIR, { recursive: true });
+        }
         this.loadHistory();
     }
 
     private loadHistory() {
         try {
-            if (fs.existsSync(this.filePath)) {
-                const data = fs.readFileSync(this.filePath, 'utf-8');
+            if (fs.existsSync(POST_HISTORY_FILE)) {
+                const data = fs.readFileSync(POST_HISTORY_FILE, 'utf-8');
                 this.history = JSON.parse(data);
             }
         } catch (error) {
@@ -27,13 +31,7 @@ export class PostHistoryManager {
 
     private saveHistory() {
         try {
-            // Ensure the directory exists
-            const dir = path.dirname(this.filePath);
-            if (!fs.existsSync(dir)) {
-                fs.mkdirSync(dir, { recursive: true });
-            }
-            
-            fs.writeFileSync(this.filePath, JSON.stringify(this.history, null, 2));
+            fs.writeFileSync(POST_HISTORY_FILE, JSON.stringify(this.history, null, 2));
         } catch (error) {
             console.error('Error saving post history:', error);
         }