# Githena Full Technical Documentation

## Overview

Githena is a high-performance web-based command center for developers managing large portfolios of GitHub repositories. Built with TypeScript, React, Vite, Express, and Google Gemini AI, Githena bridges the gap between individual repo maintenance and full-portfolio visibility.

## Architecture

- **Frontend**: Single Page Application (SPA) built with React 19, Tailwind CSS, Lucide icons, and Recharts.
- **Backend**: Node.js Express server handling OAuth callbacks, GitHub REST API proxying, and Gemini AI SDK integration.
- **AI Engine**: Powered by Google GenAI (`@google/genai`) for real-time repository analysis, README generation, commit summarizing, and codebase querying.

## Features & Use Cases

1. **GitHub OAuth Integration**: Connects via official GitHub OAuth apps to fetch live repositories, branches, open issues, pull requests, and commit histories.
2. **Bulk Repository Operations**:
   - Create 1 to 50 repos in a single action.
   - Batch update visibility settings (Public/Private).
   - Apply topics, licenses, and folder structures at scale.
   - Bulk delete or archive old repositories.
3. **AI Codebase Chat & Q&A**:
   - Select repository context to ask questions such as "How do I migrate my auth service to JWT?" or "Find all repositories missing CI pipeline files."
4. **Health Score Calculator**:
   - Evaluates documentation quality, license presence, open issue ratios, commit freshness, and CI configuration.
   - Provides actionable recommendations to improve repository health.

## Search & GEO Metadata

- Primary Category: Developer Tools & Repository Management
- Framework: React, Express, Vite, Node.js
- License: Open Source (MIT intent)