Metadata-Version: 2.4
Name: docnet
Version: 0.1.0
Summary: Instant local file documentation — point it at any folder and browse
License: MIT
Project-URL: Homepage, https://github.com/yourname/docnet
Project-URL: Issues, https://github.com/yourname/docnet/issues
Keywords: documentation,markdown,file browser,notes,local
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: flask>=2.3
Requires-Dist: markdown>=3.4
Dynamic: license-file

# DocNet

Instant local file wiki. Point it at any folder and get a clean, searchable browser for all your files.

```bash
pip install docnet
docnet ~/notes
```

## Features

- **Zero config** — just run it in a directory
- **Multi-filetype** — markdown, code (20+ languages), CSV, JSON, images, PDFs
- **Full-text search** — search filenames and file content with highlighted snippets
- **5 themes** — light, dark, ocean, forest, rose
- **Recent pages** — sidebar tracks what you've visited
- **Safe** — path traversal protection, never serves files outside the target directory

## Usage

```bash
docnet                        # serve current directory
docnet ~/notes                # serve a specific folder
docnet ~/notes -p 8080        # custom port
docnet ~/notes --host 0.0.0.0 # expose on local network (share with phone etc.)
docnet ~/notes --no-browser   # don't auto-open browser
docnet --version
```

## File support

| Type | Extensions |
|------|-----------|
| Markdown | `.md` (with mermaid diagrams) |
| Code | `.py .js .ts .jsx .tsx .rs .go .java .c .cpp .rb .php .swift .kt .sh .css .scss .html` |
| Data | `.json .yaml .toml .csv` |
| Images | `.png .jpg .gif .webp .svg` |
| Documents | `.pdf .txt .log` |

## Home page

If a `Home.md` exists in the directory it's shown on launch. Otherwise an auto-generated index of all files is shown.

## Install from source

```bash
git clone https://github.com/yourname/docnet
cd docnet
pip install -e .
```

## License

MIT
