# DocApp

DocApp is a specification and reference implementation for a way to browse markdown files with built-in support for offline access, archiving, and preservation.

## Key Features

- **Documents written in GitHub-Flavored Markdown:** widely adopted, lots of existing content online, plenty of open source libraries to aid in building clients
- **Offline-accessible:** when you access a markdown document it’s stored locally in your client app indefinitely, and can be accessed even if you are offline
- **Takedown-durable:** even if the original source is removed, it is stored on a local server you belong to, and can be accessed again, even from other devices of yours or by other users on your local server
- **Read/write:** the same tools that let you browse others’ documents let you create and share your own
- **Interoperable:** it allows all the above benefits for viewing markdown documents hosted on the traditional web, and when you host markdown documents on it they can be viewed by others in  a web browser

## Try It

DocApp is intended to be an open specification for which developers can implement their own client/server stacks. A reference client/server stack is provided as a first use option, a demonstration, and a prompt for conversations iterating the spec.

You can try out DocApp for free by downloading the reference client for Android or for iPhone, iPad, or macOS and creating a free account on [my.docapp.page](https://my.docapp.page). Windows and Linux clients are planned for the future if the platform gains adoption.

Learn more about the [reference implementation](https://docapp.page/reference-implementation).

## More Info

The following are in progress

- [Problem Statement](https://docapp.page/problem-statement)
- [Goals](https://docapp.page/goals)
- [Use Cases](https://docapp.page/use-cases)
- [Markdown Support](https://docapp.page/markdown)
- [DocApp Spec](https://docapp.page/spec)
- [Alternatives](hitps://docapp.page/alternatives) with related goals, and how they relate

## Contact

DocApp is developed by Josh Justice. You can reach me at:

- Email: my first name at this page’s domain name
- Mastodon: [@codingitwrong@oldbytes.space](https://oldbytes.space/@CodingItWrong)