Content Sentinel

Description

In fact, this is a dashboard that allows you to monitor and manage the data of the content-alchemist database and cron tasks of content-maestro using their APIs. Therefore, for this app to work correctly, you need to run both content-alchemist and content-maestro first.

Features

• Posts Generation: Manually generate posts by repository URL or from trending GitHub repositories
• Status Tracking: Monitor which repositories have been or will be posted to social media next
• Posts Management: View, search, and filter posts
• Dark/Light Mode: Toggle the interface between dark and light themes

Technology Stack

• Frontend: React 18 with TypeScript
• Styling: Tailwind CSS
• Build Tool: Vite
• Icons: Lucide React

Screenshots (may be outdated)

Show me what's hidden

Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm

Installation

1. Clone the repository

   git clone https://github.com/think-root/content-sentinel.git
   cd content-sentinel

2. Install dependencies

   npm ci --production

3. Create an environment file

   cp .env.example .env

4. Update the .env file with your data

   PORT=3000

5. Build project

   npm run build

6. Start the preview server at http://localhost:4173/dashboard/

   npm run preview

7. Run production server at http://localhost:3000/dashboard/

   npm start

Docker

Run via docker compose:

docker compose up -d

Or run the container directly:

docker run -d \
  --name content-sentinel \
  -p ${PORT:-3000}:${PORT:-3000} \
  --env-file .env \
  --restart unless-stopped \
  content-sentinel:latest

Access the application at http://localhost:3000/dashboard/

Configuration Settings

For successful use, you must fill in some settings that can be found in the site header on the right, the “Settings” button.

Tab	Setting	Description
General	Date Format	Choose your preferred date format. Available formats: DD (day), MM (month), YYYY (year), HH (24h), hh (12h), mm (minutes), ss (seconds), A (AM/PM uppercase), a (am/pm lowercase). Default: DD.MM.YYYY HH:mm
	Timezone	Select your timezone (default: Europe/Kyiv)
Content Alchemist API	API Base URL	Enter the URL of your Content Alchemist API
	API Bearer Token	Provide your authentication token for API access
Content Maestro API	API Base URL	Enter the URL of your Content Maestro API
	API Bearer Token	Provide your authentication token for API access

All settings are automatically saved and persisted in your browser's local storage.

Development

1. Install the development dependencies and start the development server:

   npm install
   npm run dev

2. Access the application at http://localhost:5173/dashboard/

License

This project is licensed under the terms found in the LICENSE file in the repository root.