Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/itsalb3rt/afterman

🌕 Create beutiful docs in markdown and HTML from postman collection
https://github.com/itsalb3rt/afterman

collection docker hacktoberfest javascript postman quasar-framework vue

Last synced: 3 months ago
JSON representation

🌕 Create beutiful docs in markdown and HTML from postman collection

Awesome Lists containing this project

README

        

# ![Mars](https://i.ibb.co/RQvDFQP/astronomy.png) Afterman

Export beautiful docs in **Markdown** and **HTML** from postman collection

- :ghost: No Backend
- :wrench: No configuration
- :fire: Customize the output of your documentation *(Include Dark mode)*
- :tada: Only HTML, CSS and Javascript (**Quasar Framework power**)

> Note: The tool covers the basic options of a collection, variables, description, headers, body, routes, as needs arise more things will be added.

### Main view

![Main view](https://i.ibb.co/Qcj7Ssg/main.png)

## Table of content

- [Rules](#Rules)
- [Get started](#get-started)
- [Docker](#docker)
- [Tools for build this Web App](#tools)

## Rules

The collection must be exported in version 2.1 and the requests must be organized in folders.

![postman collection demo image](https://i.ibb.co/N37FxYC/Screenshot-2.png)

After this there is nothing else! :smile:

---

## Get started

```bash
$ git clone https://github.com/itsalb3rt/afterman.git
$ cd afterman
```

### Install the dependencies
```bash
$ npm install
```

#### Start the app in development mode (hot-code reloading, error reporting, etc.)
```bash
$ quasar dev
```

#### Build the app for production

```bash
$ quasar build
```
---

## Docker

```bash
$ docker build -t afterman .
```

```bash
$ docker run -d --name afterman -p 8000:80 --rm afterman
```

We should now be able to access the application on [http://localhost:8000](http://localhost:8000)

---

## Tools

Made with the :heart: and of course with these great tools

- [Quasar Framework](https://github.com/quasarframework/quasar)
- [QMarkdown extension](https://github.com/quasarframework/quasar-ui-qmarkdown)
- [UniqId](https://github.com/adamhalasz/uniqid)
- [Turndown](https://github.com/domchristie/turndown)