logto/packages/core/README.md

# @logto/core

The core backend service.

## Get Started

Copy proper `.env` to project root. (TBD: design the config process)

```bash
yarn && yarn dev
```

## OpenAPI Doc

OpenAPI (Swagger) json is available on `http(s)://your-domain/api/swagger.json`. If you are running locally, the default URL will be `http://localhost:3001/api/swagger.json`. Consume it in the way you like.

### Using ReDoc

The doc website can be served by [redoc-cli](https://github.com/Redocly/redoc/blob/master/cli/README.md) in an extremely easy way:

```bash
npx redoc-cli serve http://localhost:3001/api/swagger.json
```

### Using Swagger Editor

Copy the API output and paste it in the [Swagger Editor](https://editor.swagger.io/).
chore: update README 2021-07-25 09:44:07 -05:00			`# @logto/core`
Initial commit 2021-06-06 05:30:37 -05:00
chore: update README 2021-07-25 09:44:07 -05:00			`The core backend service.`
Initial commit 2021-06-06 05:30:37 -05:00
			`## Get Started`

docs: remove out-dated env sample 2021-07-09 10:27:46 -05:00			Copy proper `.env` to project root. (TBD: design the config process)
Update README.md 2021-06-29 10:04:20 -05:00
Initial commit 2021-06-06 05:30:37 -05:00			```bash
			`yarn && yarn dev`
			```

feat: auto-gen api doc 2021-07-23 10:10:54 -05:00			`## OpenAPI Doc`
Initial commit 2021-06-06 05:30:37 -05:00
feat: auto-gen api doc 2021-07-23 10:10:54 -05:00			OpenAPI (Swagger) json is available on `http(s)://your-domain/api/swagger.json`. If you are running locally, the default URL will be `http://localhost:3001/api/swagger.json`. Consume it in the way you like.

			`### Using ReDoc`

			`The doc website can be served by [redoc-cli](https://github.com/Redocly/redoc/blob/master/cli/README.md) in an extremely easy way:`

			```bash
			`npx redoc-cli serve http://localhost:3001/api/swagger.json`
			```

			`### Using Swagger Editor`

			`Copy the API output and paste it in the [Swagger Editor](https://editor.swagger.io/).`