# ShipDocs Free Tools

> Eleven small, free tools that read a public repository URL and return something useful in seconds. Powered by the same indexer that generates full ShipDocs documentation. No signup required.

**URL:** https://shipdocs.sh/tools

## Tools

### 1. AI README Generator
- **URL:** https://shipdocs.sh/tools/readme
- **Markdown:** https://shipdocs.sh/tools/readme.md
- Drop in a public repo URL, get a complete `README.md` generated from the actual source. Includes stack detection, quick-start commands, project structure, and key concepts.

### 2. Repo Complexity Score
- **URL:** https://shipdocs.sh/tools/complexity
- **Markdown:** https://shipdocs.sh/tools/complexity.md
- A 0–100 complexity score with the signals behind it: file count, total lines, language mix, dependency depth, deepest paths, and longest files in the project.

### 3. Explain Repo in a Tweet
- **URL:** https://shipdocs.sh/tools/tweet
- **Markdown:** https://shipdocs.sh/tools/tweet.md
- One tweet (≤240 chars) or a 4-tweet thread that explains what a public repo actually is - based on the real code, not the README.

### 4. AI Dockerfile Generator
- **URL:** https://shipdocs.sh/tools/dockerfile
- **Markdown:** https://shipdocs.sh/tools/dockerfile.md
- Generate a production-ready Dockerfile from any public repo. Multi-stage builds, pinned versions, non-root user — all inferred from the code.

### 5. Architecture Diagram
- **URL:** https://shipdocs.sh/tools/architecture
- **Markdown:** https://shipdocs.sh/tools/architecture.md
- Generate a Mermaid flowchart showing modules, dependencies, and data flow from any public repo. Rendered visually with copyable source.

### 6. Production Readiness Audit
- **URL:** https://shipdocs.sh/tools/audit
- **Markdown:** https://shipdocs.sh/tools/audit.md
- A 0–100 production readiness score for any public repository.
- **Categories scored:**
  - Documentation
  - Dev environment setup
  - CI / testing
  - Secrets hygiene
  - Dependency health
- Each check shows pass/fail with detail

### 7. Repo Wrapped
- **URL:** https://shipdocs.sh/tools/wrapped
- **Markdown:** https://shipdocs.sh/tools/wrapped.md
- Spotify Wrapped-style stats for repository languages, size, dependencies, and personality tags.

### 8. Onboarding Time Estimator
- **URL:** https://shipdocs.sh/tools/onboarding
- **Markdown:** https://shipdocs.sh/tools/onboarding.md
- Estimate time to a first meaningful PR from complexity and documentation signals.

### 9. Docs Gap Map
- **URL:** https://shipdocs.sh/tools/docs-gap
- **Markdown:** https://shipdocs.sh/tools/docs-gap.md
- Find source-code directories missing nearby documentation.

### 10. Dependency Time Bomb
- **URL:** https://shipdocs.sh/tools/deps
- **Markdown:** https://shipdocs.sh/tools/deps.md
- Flag unpinned and risky dependency version signals.

### 11. Dead Code / Orphan Finder
- **URL:** https://shipdocs.sh/tools/dead-code
- **Markdown:** https://shipdocs.sh/tools/dead-code.md
- Find candidate files with no matching import or path reference.