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

https://github.com/platform-kit/docs

Static documentation generator & PWA.
https://github.com/platform-kit/docs

Last synced: 11 months ago
JSON representation

Static documentation generator & PWA.

Awesome Lists containing this project

README

          

PlatformKit Docs


Static Documentation Generator


Search, analytics, pdf export, & offline mode.



**Built with:**






**Deploy with:**



**License:**

## Features

- Generate beautiful, searchable docs from [Markdown](https://www.markdownguide.org) files
- Frontmatter support (title, description, git repo, website)
- Progressive Web App (works offline)
- Automated reading time estimates
- Code syntax highlighting
- Zero-config analytics
- Emoji based feedback
- Export docs as PDF

## Local Development

Clone the project

```bash
git clone https://github.com/platform-kit/docs pk-docs
```

Go to the project directory

```bash
cd pk-docs
```

Install dependencies

```bash
npm install
```

Start the server

```bash
npm run dev
```

A local instance is now running at `https://localhost:3000`

### Configuration

Before use, you will need to add the following environment variables to your .env file

```env
REPO=
SITE_NAME=
BUILD_COMMAND=
CONTENT_DIRECTORY=
```

## Deployment

To deploy to the cloud, simply click one of the buttons below.

Note: if you deploy to Netlify, you will have to provision a database manually.