Skip to content

Commit 75df786

Browse files
authored
Address feedback, fix linter warnings and add CI workflow (#36)
* fix: remark-lint:unordered-list-marker-style Marker style should be - `npx awesome-lint README.md` * fix: MD022/blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## React"] * fix: MD007/ul-indent Unordered list indentation [Expected: 2; Actual: 4] * fix: MD012/no-multiple-blanks Multiple consecutive blank lines [Expected: 1; Actual: 2] * ci: run linters * The description starts with an uppercase character and ends with a period. * Improve list * Fix name inconsistencies * Improve list * Improve description * fix: remark-lint:awesome-list-item List item link and description must be separated with a dash
1 parent aedf773 commit 75df786

File tree

4 files changed

+81
-27
lines changed

4 files changed

+81
-27
lines changed

.github/workflows/lint.yml

+43
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
name: Lint
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
pull_request:
8+
9+
jobs:
10+
lychee:
11+
runs-on: ubuntu-latest
12+
steps:
13+
- uses: actions/checkout@v4
14+
15+
- name: Check links
16+
id: lychee
17+
uses: lycheeverse/[email protected]
18+
with:
19+
# Exclude twitter.com (https://github.com/lycheeverse/lychee/issues/989)
20+
args: README.md --verbose --no-progress --exclude twitter.com
21+
fail: true
22+
env:
23+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
24+
25+
markdown:
26+
runs-on: ubuntu-latest
27+
steps:
28+
- uses: actions/checkout@v4
29+
30+
- uses: DavidAnson/markdownlint-cli2-action@v15
31+
with:
32+
globs: |
33+
README.md
34+
contributing.md
35+
36+
awesome-lint:
37+
runs-on: ubuntu-latest
38+
steps:
39+
- uses: actions/checkout@v4
40+
with:
41+
fetch-depth: 0
42+
43+
- run: npx awesome-lint

.markdownlint.yml

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# MD013/line-length
2+
MD013: false
3+
# False positive with C# heading
4+
#README.md:53 MD003/heading-style Heading style [Expected: atx; Actual: atx_closed]
5+
#README.md:53:4 MD020/no-missing-space-closed-atx No space inside hashes on closed atx style heading [Context: "## C#"]
6+
MD003: false
7+
MD020: false
8+

README.md

+29-26
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
# Awesome PocketBase [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
22

3-
This is a collection of [PocketBase](https://pocketbase.io) community resources. Please send suggestions in the form of pull requests.
3+
> Curated list of awesome [PocketBase](https://pocketbase.io) resources.
4+
5+
PocketBase is an open source backend consisting of embedded database (SQLite) with realtime subscriptions, built-in auth management, convenient dashboard UI and simple REST-ish API.
46

57
## Contents
68

@@ -14,40 +16,41 @@ This is a collection of [PocketBase](https://pocketbase.io) community resources.
1416
- [Unofficial PocketBase Clients (SDKs)](#unofficial-pocketbase-clients-sdks)
1517
- [Hosting](#hosting)
1618
- [Plugins](#plugins)
17-
- [Typescript tools](#typescript-tools)
19+
- [TypeScript tools](#typescript-tools)
1820
- [SQLite tools](#sqlite-tools)
1921
- [Other tools](#other-tools)
2022
- [Showcases](#showcases)
2123

2224
## Official Packages
2325

24-
- PocketBase [Golang Server](https://github.com/pocketbase/pocketbase/releases/) - The main PocketBase server
25-
- PocketBase [JS SDK](https://github.com/pocketbase/js-sdk) - TS/JS/node client to communicate with the server
26-
- PocketBase [Dart client](https://github.com/pocketbase/dart-sdk) - Dart client to communicate with the server
26+
- [Golang Server](https://github.com/pocketbase/pocketbase/releases/) - The main PocketBase server.
27+
- [JavaScript SDK](https://github.com/pocketbase/js-sdk) - Browser and Node.js for interacting with the PocketBase API.
28+
- [Dart SDK](https://github.com/pocketbase/dart-sdk) - Multi-platform SDK for interacting with the PocketBase Web API.
2729

2830
## React
29-
- [PocketBase React](https://github.com/tobicrain/pocketbase-react) - Unofficial React SDK (React, React Native, Expo) for interacting with the PocketBase JS SDK.
31+
32+
- [PocketBase React](https://github.com/tobicrain/pocketbase-react) - Unofficial React SDK (React, React Native, Expo) for interacting with the PocketBase JavaScript SDK.
3033

3134
## Svelte
3235

33-
* [svelte-query-pocketbase](https://github.com/goknsh/svelte-query-pocketbase) - TanStack Query wrappers around PocketBase for Svelte and SvelteKit that updates the query cache in realtime.
34-
* [SvelteKit Starter](https://github.com/spinspire/pocketbase-sveltekit-starter) - A starter-kit showing how to use customized PocketBase as a backend to SvelteKit frontend.
35-
* [SvelteKit Auth](https://github.com/danawoodman/sveltekit-auth-example) - This project is designed as a sample implementation reference for getting authentication setup using SvelteKit.
36-
* [SvelteKit PocketBase Auth](https://github.com/jianyuan/pocketbase-sveltekit-auth) - This project demonstrates how to integrate PocketBase with SvelteKit. The project includes login and registration pages, as well as examples of how to retrieve the current user. You can watch a video of the creation of this project on YouTube at [this link](https://youtu.be/AxPB3e-3yEM).
37-
* [pocketbase-sveltekit-static](https://github.com/Egor-S/pocketbase-sveltekit-static) - A minimalistic template with configured authorization featuring a single Docker image (from 55 MB) for deploying.
36+
- [svelte-query-pocketbase](https://github.com/goknsh/svelte-query-pocketbase) - TanStack Query wrappers around PocketBase for Svelte and SvelteKit that updates the query cache in realtime.
37+
- [SvelteKit Starter](https://github.com/spinspire/pocketbase-sveltekit-starter) - A starter-kit showing how to use customized PocketBase as a backend to SvelteKit frontend.
38+
- [SvelteKit Auth](https://github.com/danawoodman/sveltekit-auth-example) - This project is designed as a sample implementation reference for getting authentication setup using SvelteKit.
39+
- [SvelteKit PocketBase Auth](https://github.com/jianyuan/pocketbase-sveltekit-auth) - This project demonstrates how to integrate PocketBase with SvelteKit. The project includes login and registration pages, as well as examples of how to retrieve the current user. You can watch a video of the creation of this project on YouTube at [this link](https://youtu.be/AxPB3e-3yEM).
40+
- [pocketbase-sveltekit-static](https://github.com/Egor-S/pocketbase-sveltekit-static) - A minimalistic template with configured authorization featuring a single Docker image (from 55 MB) for deploying.
3841

3942
## Vue
4043

4144
- [Vue 3 + Vite starter kit](https://github.com/StefanVDWeide/pocketbase-vue) - A starter kit for Vue 3 + Vite + PocketBase.
42-
- [Tutorial](https://studioterabyte.nl/en/blog/pocketbase-vue-3)
45+
- [Tutorial](https://studioterabyte.nl/en/blog/pocketbase-vue-3)
4346
- [Quasar starter kit](https://github.com/aaronblondeau/pocketbase_quasar_starter)
44-
- [PocketNuxt](https://github.com/j-wil/pocket-nuxt) - A Nux3 Pocketbase starter that builds into a single binary.
47+
- [PocketNuxt](https://github.com/j-wil/pocket-nuxt) - A Nux3 PocketBase starter that builds into a single binary.
4548

4649
## Dart/Flutter
4750

4851
- [PocketBase Drift](https://github.com/rodydavis/pocketbase_drift) - A PocketBase client cached with Drift.
4952
- [Dart Generator](https://github.com/rodydavis/pocketbase_dart_generator) - Generate type safe client SDKs for use in local SQLite, JSON or GraphQL resolvers.
50-
- [Pocketbase Server Flutter](https://github.com/rohitsangwan01/pocketbase_server_flutter) - A Flutter plugin to run PocketBase server directly from Android/iOS.
53+
- [PocketBase Server Flutter](https://github.com/rohitsangwan01/pocketbase_server_flutter) - A Flutter plugin to run PocketBase server directly from Android/iOS.
5154

5255
## C#
5356

@@ -68,28 +71,28 @@ This is a collection of [PocketBase](https://pocketbase.io) community resources.
6871

6972
## Hosting
7073

71-
- [pockethost.io](https://pockethost.io) - Hosted and managed PocketBase with email and SSL support. Up and running in 30 seconds. Supports JS/TS serverless cloud functions.
74+
- [pockethost.io](https://pockethost.io) - Hosted and managed PocketBase with email and SSL support. Up and running in 30 seconds. Supports JavaScript and TypeScript serverless cloud functions.
7275
- [PocketBase Docker](https://github.com/muchobien/pocketbase-docker) - Docker setup supporting multiple architectures and automatically updated with PocketBase releases.
73-
- Deploy on Digital Ocean [link](https://github.com/pocketbase/pocketbase/discussions/512).
74-
- Host free on fly.io [link](https://github.com/pocketbase/pocketbase/discussions/537).
75-
- Use LocalXpose to allow public access to a localhost PocketBase instance [link](https://localxpose.io/docs/tutorials/expose-pocketbase-backend).
76+
- [DigitalOcean](https://github.com/pocketbase/pocketbase/discussions/512) - Guide to deploy in a Droplet.
77+
- [Fly.io](https://github.com/pocketbase/pocketbase/discussions/537) - Guide to deploy for free in Fly.io.
78+
- [LocalXpose](https://localxpose.io/docs/tutorials/expose-pocketbase-backend) - Allow public access to a localhost instance.
7679

7780
## Plugins
7881

79-
- [Telegram auth](https://github.com/iamelevich/pocketbase-plugin-telegram-auth) - Plugin that add Telegram auth (Widget button and WebApp).
80-
- [Ngrok](https://github.com/iamelevich/pocketbase-plugin-ngrok) - Plugin that allow to expose local PocketBase to the internet with ngrok. Can be useful for development purposes.
81-
- [Proxy](https://github.com/iamelevich/pocketbase-plugin-proxy) - Plugin that allow to proxify requests to the other host. Can be useful when you want to use separate server as frontend (like Next.js), but serve everything with same port.
82+
- [Telegram auth](https://github.com/iamelevich/pocketbase-plugin-telegram-auth) - Add Telegram auth (Widget button and WebApp).
83+
- [Ngrok](https://github.com/iamelevich/pocketbase-plugin-ngrok) - Allow to expose local PocketBase to the internet with ngrok. Can be useful for development purposes.
84+
- [Proxy](https://github.com/iamelevich/pocketbase-plugin-proxy) - Allow to proxify requests to the other host. Can be useful when you want to use separate server as frontend (like Next.js), but serve everything with same port.
8285

83-
## Typescript tools
86+
## TypeScript tools
8487

85-
- [pb_hooks starter kit](https://github.com/benallfree/ts-pb-hooks-starter) - Build PocketBase JS hooks using Typescript.
86-
- [PocketBase Typegen](https://github.com/patmood/pocketbase-typegen) - Generate Typescript types from the SQLite db file.
88+
- [pb_hooks starter kit](https://github.com/benallfree/ts-pb-hooks-starter) - Build PocketBase JavaScript hooks using TypeScript.
89+
- [PocketBase Typegen](https://github.com/patmood/pocketbase-typegen) - Generate TypeScript types from the SQLite db file.
8790
- [pocketbase-ts](https://github.com/Solaris9/pocketbase-ts) - A simplified PocketBase SDK to ease the developer experience. Modular API. Strongly typed Schemas.
88-
- [typed-pocketbase](https://github.com/david-plugge/typed-pocketbase) - Generate types from your Pocketbase instance and enjoy fully type-safe queries.
91+
- [typed-pocketbase](https://github.com/david-plugge/typed-pocketbase) - Generate types from your PocketBase instance and enjoy fully type-safe queries.
8992

9093
## SQLite tools
9194

92-
- [Marmot](https://github.com/maxpert/marmot) - A distributed SQLite replicator [with PocketBase tutorial](https://www.youtube.com/watch?v=Zapupe_FREc)
95+
- [Marmot](https://github.com/maxpert/marmot) - A distributed SQLite replicator [with PocketBase tutorial](https://www.youtube.com/watch?v=Zapupe_FREc).
9396
- [Litestream](https://litestream.io/) - Streaming SQLite replication.
9497
- [PocketBase+Litestream example](https://github.com/TylerSustare/pocketbase-framework-litestream) - Template showing Litestream running with PocketBase.
9598
- [PocketBase with Litestream](https://github.com/bscott/pocketbase-litestream/) - Docker example of PocketBase saving/restoring from Litestream.

contributing.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@ Make sure your pull request follows these guidelines:
1212

1313
See also the upstream Awesome project's [contribution guidelines](https://github.com/sindresorhus/awesome/blob/main/contributing.md) and [manifesto/requirements](https://github.com/sindresorhus/awesome/blob/main/awesome.md). Some of the more basic entry formatting requirements are checked via a [awesome-lint](https://github.com/sindresorhus/awesome-lint) GitHub Action; run it locally first if you can!
1414

15-
Thanks for contributing!
15+
Thanks for contributing!

0 commit comments

Comments
 (0)