Skip to content

RevivalHub is an AI-driven app search and discovery engine. Unlike traditional directories or platforms like Product Hunt, it uses an autonomous crawler to continuously explore, analyze, and index the software ecosystem, providing a smarter, more efficient way to find apps and tools.

Notifications You must be signed in to change notification settings

HeyBaldur/RevivalHubUI

Repository files navigation

🕸️ RevivalHub – Unified Project Guide

Angular .NET License

RevivalHub is an app search and discovery engine that combines cutting-edge technology with an AI-driven approach. Unlike traditional directories or platforms like Product Hunt, RevivalHub doesn't rely on manual listings; instead, it uses its own autonomous crawler, capable of continuously exploring the software and app ecosystem, analyzing its content, and generating a dynamic discovery index.

RevivalHub aims to provide a smarter and more efficient experience for finding apps, tools, and software, functioning both as an alternative search engine and a platform for discovering highly relevant apps.

image

Project Links:


🕷️ RevivalHub API

Description: Open-source engine for software discovery. Uses a crawler to explore software sites, processes content with Generative AI (Google Gemini), and provides a search API.

🔹 Badges: ✅ Build: passing | 📝 License: MIT | ⚡ .NET: 8.0 / 9.0

Architecture

  • Framework: .NET Core (C#)
  • Database: MongoDB (document storage for tools, logs, analytics)
  • Caching & Queue: Redis (crawler queue + API caching)
  • AI Processing: Google Vertex AI / Gemini
  • Documentation: Swagger / OpenAPI

Getting Started

Prerequisites:

Docker Infrastructure: Run docker-compose up -d from the solution root. Services started:

  • 🗄️ MongoDB → localhost:27017
  • ⚡ Redis → localhost

Configuration & Secrets 🔐: Set sensitive keys using .NET User Secrets:

  • GeminiSettings:ApiKey
  • Jwt:Key (32+ chars)
  • AutoMapper:LicenseKey
  • Redis:Password (if applicable)

Running the API:

  • Visual Studio: Open RevivalHub.sln → set RevivalHub.Api as startup → Run
  • Terminal / VS Code: cd RevivalHub.Apidotnet watch run → Swagger UI at https://localhost:7xxx/swagger

Project Structure:

  • RevivalHub.Api → Controllers, Dependency Injection
  • Services → Business logic (crawler, AI, search)
  • Repositories → Data access (MongoDB, Redis)
  • DAL → Data models & DTOs

Contributing:

License: MIT


🎨 RevivalHub UI

Description: Frontend client with a modern, responsive interface. Includes Server-Side Rendering (SSR) for fast performance and SEO optimization.

🔹 Badges: ⚛️ Angular v20 | 🌈 Tailwind CSS | 📝 MIT License

Tech Stack

  • Angular 20
  • Tailwind CSS
  • Standalone Components, Signals, OnPush Strategy
  • SSR via Angular Universal / Hydration

Getting Started

Prerequisites:

  • Node.js v20+
  • NPM
  • IDE: VS Code / Cursor

Installation:

git clone https://github.com/HeyBaldur/RevivalHubUI.git
cd RevivalHubUI
npm install

Environment Configuration:

  • environment.ts → development
  • environment.prod.ts → production Set apiUrl to your running backend (https://localhost:7xxx/api)

Running the UI:

  • Development server: ng serve or npm starthttp://localhost:4200
  • SSR (Hydration test): npm run serve:ssr

Code Scaffolding: Use Angular CLI to generate components, services, directives, pipes, etc. Only standalone components unless a module is strictly required.

Design System:

  • Colors: Dark Mode bg-gray-900, Brand text-blue-500
  • Icons: Heroicons SVG directly (avoiding large libraries)

Contributing: Fork → Branch → Implement changes → Pull Request

License: MIT


🐳 Docker Compose (Local Development)

Services:

  • 🗄️ MongoDB → port 27017 → volume mongo_data
  • ⚡ Redis → port 6379 → optional password
  • 🖥️ Redis Commander GUI → port 8081 → depends on Redis

Volumes:

  • mongo_data

Run docker-compose up -d to start all required services for local development.


This unified guide now:

  • Covers both UI and API projects in one document
  • Includes icons for readability
  • Shows badges and repo links
  • Explains Docker setup clearly
  • Keeps a professional tone suitable for contributors or team onboarding

Contributing:

About

RevivalHub is an AI-driven app search and discovery engine. Unlike traditional directories or platforms like Product Hunt, it uses an autonomous crawler to continuously explore, analyze, and index the software ecosystem, providing a smarter, more efficient way to find apps and tools.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published