@malikasadjaved/readme-ai 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 readme-ai contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,309 @@
+<div align="center">
+
+# readme-ai
+
+> Generate stunning, production-quality READMEs from any codebase in seconds
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-3178C6?style=flat-square&logo=typescript)](#)
+[![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A518-5FA04E?style=flat-square&logo=nodedotjs)](#)
+[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](#license)
+[![npm](https://img.shields.io/npm/v/readme-ai?style=flat-square&logo=npm)](https://www.npmjs.com/package/readme-ai)
+
+**One command. Zero install. Beautiful READMEs.**
+
+[Quick Start](#-quick-start) · [Themes](#-themes) · [Providers](#-ai-providers) · [CLI Options](#-cli-options) · [GitHub Action](#-github-action)
+
+</div>
+
+---
+
+## Overview
+
+**readme-ai** reads your actual source code — not just directory names — and generates a complete, polished README with architecture diagrams, badges, install instructions, usage examples, and API docs. Point it at any local project or public GitHub repo and get a production-ready README in seconds.
+
+Unlike existing tools, readme-ai goes deep: it parses dependencies, detects frameworks, extracts API endpoints and CLI commands, and builds Mermaid architecture diagrams automatically. It supports 5 visual themes and 4 AI providers (including fully local generation via Ollama).
+
+## Key Features
+
+- **npx-first** — zero install, works instantly: `npx readme-ai`
+- **Deep code analysis** — reads actual source files, extracts functions, endpoints, and CLI commands
+- **Auto Mermaid diagrams** — generates architecture diagrams from your code structure
+- **5 beautiful themes** — Default, Modern, Hacker, Minimal, Academic
+- **4 AI providers** — Claude, GPT-4o, Gemini, Ollama (free & local)
+- **Smart badge generation** — auto-detects language, frameworks, CI, Docker, license
+- **GitHub URL support** — `npx readme-ai github:user/repo` analyzes any public repo
+- **GitHub Action included** — auto-regenerate your README on every push
+
+## Quick Start
+
+```bash
+# Generate README for current directory
+npx readme-ai
+
+# Point at a local project
+npx readme-ai ./my-project
+
+# Point at a GitHub repo
+npx readme-ai github:expressjs/express
+
+# Interactive mode (guided prompts)
+npx readme-ai --interactive
+```
+
+## Comparison
+
+| Feature | readme-ai | eli64s/readme-ai | readmeX |
+|---------|:---------:|:----------------:|:-------:|
+| npx support (zero install) | **Yes** | No | No |
+| Mermaid architecture diagrams | **Yes** | No | No |
+| GitHub URL analysis | **Yes** | Yes | Yes |
+| Multiple themes | **5** | 3 | No |
+| GitHub Action template | **Yes** | No | No |
+| API docs from code | **Yes** | No | No |
+| Badge auto-generation | **Yes** | Yes | Partial |
+| Local AI (Ollama) | **Yes** | No | No |
+
+## Themes
+
+### Default — Clean & Professional
+The standard theme with a centered header, emoji section headers, and shields.io badges.
+
+### Modern — Emoji-rich & Colorful
+Heavy use of emojis, colorful badge rows, and visual separators for maximum impact.
+
+### Hacker — Terminal Aesthetic
+ASCII art header, monospace styling, `>` prefixed descriptions — for the terminal lovers.
+
+### Minimal — Pure Markdown
+No emojis, no badges, no frills. Just clean, readable markdown.
+
+### Academic — Formal & Structured
+Numbered sections, citation-style references, formal language. Great for research projects.
+
+```bash
+# Use a specific theme
+npx readme-ai --theme modern
+npx readme-ai --theme hacker
+npx readme-ai --theme minimal
+npx readme-ai --theme academic
+```
+
+## AI Providers
+
+### Claude (Anthropic) — Default
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+npx readme-ai
+```
+
+### GPT-4o-mini (OpenAI)
+
+```bash
+export OPENAI_API_KEY=sk-...
+npx readme-ai --provider openai
+```
+
+### Gemini Flash (Google)
+
+```bash
+export GEMINI_API_KEY=...
+npx readme-ai --provider gemini
+```
+
+### Ollama (Local, Free)
+
+```bash
+# Make sure Ollama is running locally
+npx readme-ai --provider ollama
+npx readme-ai --provider ollama --model llama3.1
+```
+
+## CLI Options
+
+```
+Usage: readme-ai [repo] [options]
+
+Arguments:
+  repo                     Local path or GitHub URL (github:user/repo)
+
+Options:
+  -V, --version            Output the version number
+  -o, --output <file>      Output file path (default: "README.md")
+  -p, --provider <name>    AI provider: anthropic | openai | gemini | ollama (default: "anthropic")
+  -m, --model <name>       Model name (depends on provider)
+  -t, --theme <name>       Theme: default | minimal | hacker | modern | academic (default: "default")
+  --no-diagram             Skip Mermaid architecture diagram
+  --no-badges              Skip badge generation
+  --no-api-docs            Skip API documentation section
+  --interactive            Run in interactive mode
+  --action                 Generate a GitHub Action for auto-updating README
+  --overwrite              Overwrite existing README without asking
+  --dry-run                Print README to stdout instead of writing to file
+  -h, --help               Display help for command
+```
+
+### Examples
+
+```bash
+# Generate with Modern theme using OpenAI
+npx readme-ai ./my-app --provider openai --theme modern
+
+# Dry run (preview without writing)
+npx readme-ai --dry-run
+
+# Generate without diagram and badges
+npx readme-ai --no-diagram --no-badges
+
+# Overwrite existing README and generate GitHub Action
+npx readme-ai --overwrite --action
+
+# Analyze a remote GitHub repository
+npx readme-ai github:tiangolo/fastapi --theme academic
+```
+
+## GitHub Action
+
+Auto-regenerate your README on every push to main:
+
+```bash
+# Generate the action file automatically
+npx readme-ai --action
+```
+
+Or manually create `.github/workflows/readme-update.yml`:
+
+```yaml
+name: Update README
+
+on:
+  push:
+    branches: [main, master]
+    paths-ignore:
+      - 'README.md'
+
+jobs:
+  update-readme:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Generate README
+        run: npx readme-ai@latest --overwrite --no-interactive
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+
+      - name: Commit updated README
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: 'docs: auto-update README [skip ci]'
+          file_pattern: README.md
+```
+
+## Architecture
+
+```mermaid
+graph TD
+  A[CLI Input] --> B[Command Parser]
+  B --> C[Repo Fetcher]
+  C -->|Local Path| D[File Scanner]
+  C -->|GitHub URL| E[GitHub API]
+  E --> D
+  D --> F[Code Analyzer]
+  D --> G[Dependency Analyzer]
+  F --> H[AI Provider]
+  G --> H
+  H --> I[Section Generators]
+  I --> J[Theme Engine]
+  J --> K[Markdown Writer]
+  K --> L[README.md]
+```
+
+## Project Structure
+
+```
+readme-ai/
+├── src/
+│   ├── index.ts              # CLI entry point
+│   ├── cli.ts                # Interactive mode
+│   ├── config.ts             # Configuration management
+│   ├── commands/
+│   │   └── generate.ts       # Main generation pipeline
+│   ├── analyzers/
+│   │   ├── repo-fetcher.ts   # Fetch from local or GitHub
+│   │   ├── file-scanner.ts   # Scan and categorize files
+│   │   ├── code-analyzer.ts  # Extract functions, endpoints, exports
+│   │   ├── dependency-analyzer.ts
+│   │   ├── badge-generator.ts
+│   │   └── diagram-builder.ts
+│   ├── generators/
+│   │   ├── overview.ts       # Project summary + features
+│   │   ├── install.ts        # Install instructions
+│   │   ├── usage.ts          # Usage examples + API docs
+│   │   ├── contributing.ts   # Contributing guide
+│   │   └── changelog.ts      # Changelog section
+│   ├── providers/
+│   │   ├── anthropic.ts      # Claude
+│   │   ├── openai.ts         # GPT-4o
+│   │   ├── gemini.ts         # Gemini Flash
+│   │   └── ollama.ts         # Local Ollama
+│   ├── themes/
+│   │   ├── default.ts
+│   │   ├── modern.ts
+│   │   ├── hacker.ts
+│   │   ├── minimal.ts
+│   │   └── academic.ts
+│   └── utils/
+│       ├── file-utils.ts
+│       ├── github-api.ts
+│       ├── language-detector.ts
+│       ├── markdown-writer.ts
+│       └── template-engine.ts
+├── templates/
+│   ├── github-action.yml
+│   └── .readmeaiignore.example
+└── tests/
+    ├── analyzers/
+    └── generators/
+```
+
+## Contributing
+
+Contributions are welcome! Here's how to get started:
+
+```bash
+# Clone the repo
+git clone https://github.com/malikasadjaved/readme-ai.git
+cd readme-ai
+
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+
+# Run tests
+npm test
+
+# Build
+npm run build
+```
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<div align="center">
+
+Built with readme-ai
+
+</div>

package/dist/analyzers/badge-generator.d.ts

@@ -0,0 +1,12 @@
+import type { ScanResult } from './file-scanner.js';
+import type { DependencyAnalysis } from './dependency-analyzer.js';
+import type { GitHubMeta } from '../utils/github-api.js';
+export interface Badge {
+    label: string;
+    url: string;
+    markdown: string;
+    category: 'language' | 'framework' | 'tool' | 'status' | 'meta';
+}
+export declare function generateBadges(scan: ScanResult, deps: DependencyAnalysis, githubMeta?: GitHubMeta): Badge[];
+export declare function formatBadgeRow(badges: Badge[]): string;
+//# sourceMappingURL=badge-generator.d.ts.map

package/dist/analyzers/badge-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge-generator.d.ts","sourceRoot":"","sources":["../../src/analyzers/badge-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;CACjE;AAgDD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,kBAAkB,EACxB,UAAU,CAAC,EAAE,UAAU,GACtB,KAAK,EAAE,CAoGT;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAEtD"}

package/dist/analyzers/badge-generator.js

@@ -0,0 +1,139 @@
+const STYLE = 'flat-square';
+function shieldsBadge(label, message, color, logo) {
+    const encodedLabel = encodeURIComponent(label);
+    const encodedMessage = encodeURIComponent(message);
+    let url = `https://img.shields.io/badge/${encodedLabel}-${encodedMessage}-${color}?style=${STYLE}`;
+    if (logo)
+        url += `&logo=${encodeURIComponent(logo)}`;
+    return url;
+}
+const LANGUAGE_BADGES = {
+    'TypeScript': { color: '3178C6', logo: 'typescript' },
+    'JavaScript': { color: 'F7DF1E', logo: 'javascript' },
+    'Python': { color: '3776AB', logo: 'python' },
+    'Rust': { color: '000000', logo: 'rust' },
+    'Go': { color: '00ADD8', logo: 'go' },
+    'Java': { color: 'ED8B00', logo: 'openjdk' },
+    'C#': { color: '239120', logo: 'csharp' },
+    'C++': { color: '00599C', logo: 'cplusplus' },
+    'Ruby': { color: 'CC342D', logo: 'ruby' },
+    'PHP': { color: '777BB4', logo: 'php' },
+    'Swift': { color: 'FA7343', logo: 'swift' },
+    'Kotlin': { color: '7F52FF', logo: 'kotlin' },
+    'Dart': { color: '0175C2', logo: 'dart' },
+    'Scala': { color: 'DC322F', logo: 'scala' },
+};
+const FRAMEWORK_BADGES = {
+    'React': { color: '61DAFB', logo: 'react' },
+    'Next.js': { color: '000000', logo: 'nextdotjs' },
+    'Vue': { color: '4FC08D', logo: 'vuedotjs' },
+    'Nuxt': { color: '00DC82', logo: 'nuxtdotjs' },
+    'Angular': { color: 'DD0031', logo: 'angular' },
+    'Svelte': { color: 'FF3E00', logo: 'svelte' },
+    'Express': { color: '000000', logo: 'express' },
+    'Fastify': { color: '000000', logo: 'fastify' },
+    'NestJS': { color: 'E0234E', logo: 'nestjs' },
+    'FastAPI': { color: '009688', logo: 'fastapi' },
+    'Django': { color: '092E20', logo: 'django' },
+    'Flask': { color: '000000', logo: 'flask' },
+    'Prisma': { color: '2D3748', logo: 'prisma' },
+    'Docker': { color: '2496ED', logo: 'docker' },
+    'Tailwind CSS': { color: '06B6D4', logo: 'tailwindcss' },
+    'Vite': { color: '646CFF', logo: 'vite' },
+};
+export function generateBadges(scan, deps, githubMeta) {
+    const badges = [];
+    // Primary language badge
+    if (scan.languages.length > 0) {
+        const lang = scan.languages[0];
+        const info = LANGUAGE_BADGES[lang.name];
+        if (info) {
+            const url = shieldsBadge(lang.name, `${lang.percentage}%25`, info.color, info.logo);
+            badges.push({
+                label: lang.name,
+                url,
+                markdown: `[![${lang.name}](${url})](#)`,
+                category: 'language',
+            });
+        }
+    }
+    // Framework badges
+    for (const framework of scan.frameworks) {
+        const info = FRAMEWORK_BADGES[framework];
+        if (info) {
+            const url = shieldsBadge(framework, '', info.color, info.logo);
+            badges.push({
+                label: framework,
+                url,
+                markdown: `[![${framework}](${url})](#)`,
+                category: 'framework',
+            });
+        }
+    }
+    // Node version
+    if (deps.nodeVersion) {
+        const url = shieldsBadge('Node.js', deps.nodeVersion, '5FA04E', 'nodedotjs');
+        badges.push({
+            label: 'Node.js',
+            url,
+            markdown: `[![Node.js](${url})](#)`,
+            category: 'tool',
+        });
+    }
+    // License badge
+    const license = scan.hasLicense;
+    if (license) {
+        const url = shieldsBadge('License', license, 'yellow');
+        badges.push({
+            label: 'License',
+            url,
+            markdown: `[![License](${url})](#)`,
+            category: 'meta',
+        });
+    }
+    // Docker badge
+    if (scan.hasDocker) {
+        const url = shieldsBadge('Docker', 'Ready', '2496ED', 'docker');
+        badges.push({
+            label: 'Docker',
+            url,
+            markdown: `[![Docker](${url})](#)`,
+            category: 'tool',
+        });
+    }
+    // CI/CD badge
+    if (scan.hasCICD) {
+        const url = shieldsBadge('CI/CD', 'Configured', 'brightgreen', 'githubactions');
+        badges.push({
+            label: 'CI/CD',
+            url,
+            markdown: `[![CI/CD](${url})](#)`,
+            category: 'status',
+        });
+    }
+    // Tests badge
+    if (scan.hasTests) {
+        const url = shieldsBadge('Tests', 'Included', 'brightgreen', 'vitest');
+        badges.push({
+            label: 'Tests',
+            url,
+            markdown: `[![Tests](${url})](#)`,
+            category: 'status',
+        });
+    }
+    // GitHub badges
+    if (githubMeta) {
+        const starsUrl = `https://img.shields.io/github/stars/${githubMeta.owner}/${githubMeta.repo}?style=${STYLE}`;
+        badges.push({
+            label: 'Stars',
+            url: starsUrl,
+            markdown: `[![Stars](${starsUrl})](https://github.com/${githubMeta.owner}/${githubMeta.repo})`,
+            category: 'meta',
+        });
+    }
+    return badges;
+}
+export function formatBadgeRow(badges) {
+    return badges.map(b => b.markdown).join(' ');
+}
+//# sourceMappingURL=badge-generator.js.map

package/dist/analyzers/badge-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge-generator.js","sourceRoot":"","sources":["../../src/analyzers/badge-generator.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/code-analyzer.d.ts

@@ -0,0 +1,34 @@
+import type { FileEntry } from './repo-fetcher.js';
+export interface CodeAnalysis {
+    exports: ExportInfo[];
+    mainFunctions: FunctionInfo[];
+    apiEndpoints: Endpoint[];
+    cliCommands: CLICommand[];
+    envVariables: string[];
+    externalDependencies: string[];
+}
+export interface ExportInfo {
+    name: string;
+    type: 'function' | 'class' | 'const' | 'type' | 'interface';
+    signature: string;
+    file: string;
+}
+export interface FunctionInfo {
+    name: string;
+    signature: string;
+    description: string;
+    file: string;
+}
+export interface Endpoint {
+    method: string;
+    path: string;
+    handler: string;
+    file: string;
+}
+export interface CLICommand {
+    name: string;
+    description: string;
+    file: string;
+}
+export declare function analyzeCode(keyFiles: FileEntry[]): Promise<CodeAnalysis>;
+//# sourceMappingURL=code-analyzer.d.ts.map

package/dist/analyzers/code-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/code-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,QAAQ,EAAE,CAAC;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAsC9E"}