Compare commits
3 Commits
e87f19e7ce
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 4a0bd62432 | |||
| d409928506 | |||
| f1e2231675 |
65
README.md
65
README.md
@@ -1,36 +1,47 @@
|
|||||||
<h1 align="center">
|
<div align="center">
|
||||||
<br>
|
<h1><a target="_blank" href="https://simple-qr.com">simple-qr.com</a></h1>
|
||||||
<img src="https://i.imgur.com/an3wOdO.png" alt="QRCode Image" width="200">
|
<img src="./docs/demo.gif" alt="demo" />
|
||||||
<br>
|
</div>
|
||||||
simple-qr.com
|
|
||||||
<br>
|
|
||||||
</h1>
|
|
||||||
|
|
||||||
<h4 align="center">Simple, bullshit-free QR code generator with straightforward API.</h4>
|
Simple, bullshit-free QR code generator with straightforward API.
|
||||||
|
|
||||||
<p align="center">
|
## What it does
|
||||||
<a href="https://nuxt.com">
|
|
||||||
<img src="https://img.shields.io/badge/nuxt-4ade80?style=for-the-badge&logo=vite&logoColor=white">
|
|
||||||
</a>
|
|
||||||
<a href="https://typescriptlang.org">
|
|
||||||
<img src="https://img.shields.io/badge/TypeScript-007acc?style=for-the-badge&logo=typescript&logoColor=white">
|
|
||||||
</a>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p align="center" id="links">
|
- Generate QR codes via a simple web UI or a straightforward REST API
|
||||||
<a href="#description">Description</a> •
|
- Embed logos (30+ brands: Gitea, Signal, Monero, Session, etc.) in the center of QR codes
|
||||||
<a href="https://simple-qr.com">Visit it</a> •
|
- Export in PNG, JPEG, or WebP formats
|
||||||
<a href="#license">License</a>
|
- No authentication, no rate limiting, no ads
|
||||||
</p>
|
|
||||||
|
|
||||||
<br>
|
## Stack
|
||||||
|
|
||||||
## Description
|
- [Nuxt 4](https://nuxt.com) + [Nuxt UI](https://ui.nuxt.com)
|
||||||
|
|
||||||
I created this side project to learn more about Nuxt and Vue, also because I needed a simple way to generate QR codes, but all websites I found were full of ads and were over complicated.
|
## API
|
||||||
|
|
||||||
<br>
|
### `GET /api` - Generate a QR code
|
||||||
|
|
||||||
## License
|
Returns the QR code as an image file.
|
||||||
|
|
||||||
This project is <a href="https://opensource.org/licenses/MIT">MIT</a> licensed.
|
| Parameter | Type | Required | Description |
|
||||||
|
|-----------|---------------------------|----------|-----------------------------------------------------|
|
||||||
|
| `content` | string | yes | Data to encode |
|
||||||
|
| `format` | `png` \| `jpeg` \| `webp` | no | Output format (default: `png`) |
|
||||||
|
| `logo` | string | no | Logo name to embed in the center (case-insensitive) |
|
||||||
|
|
||||||
|
**Example:**
|
||||||
|
```
|
||||||
|
GET https://simple-qr.com/api?content=https://git.pihkaal.me&format=webp&logo=gitea
|
||||||
|
```
|
||||||
|
|
||||||
|
### `GET /api/logos` - List available logos
|
||||||
|
|
||||||
|
Returns a JSON array of available logo names.
|
||||||
|
|
||||||
|
**Example:**
|
||||||
|
```
|
||||||
|
GET https://simple-qr.com/api/logos
|
||||||
|
```
|
||||||
|
|
||||||
|
```json
|
||||||
|
["signal", "monero", "session", ...]
|
||||||
|
```
|
||||||
|
|||||||
@@ -11,6 +11,7 @@ services:
|
|||||||
- "traefik.http.services.simple-qr.loadbalancer.server.port=3000"
|
- "traefik.http.services.simple-qr.loadbalancer.server.port=3000"
|
||||||
- "traefik.http.routers.simple-qr.tls=true"
|
- "traefik.http.routers.simple-qr.tls=true"
|
||||||
- "traefik.http.routers.simple-qr.tls.certResolver=myresolver"
|
- "traefik.http.routers.simple-qr.tls.certResolver=myresolver"
|
||||||
|
- "traefik.http.routers.simple-qr.middlewares=umami-middleware@file"
|
||||||
restart: always
|
restart: always
|
||||||
|
|
||||||
networks:
|
networks:
|
||||||
|
|||||||
BIN
docs/demo.gif
Normal file
BIN
docs/demo.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 512 KiB |
Reference in New Issue
Block a user