Popular BaaS

• Firebase
• Supabase
• Amplify

Why use PocketBase?

• Runs from a single binary
• Written in Go
  • Extend as framework
• Easy to use Dashboard

go mod init gitlab.com/hmajid2301/talks/.../example
go get github.com/pocketbase/pocketbase

// main.go

package main

import (
    "log"

    "github.com/pocketbase/pocketbase"
)

func main() {
    app := pocketbase.New()

    if err := app.Start(); err != nil {
        log.Fatal(err)
    }
}

go run main.go serve --http=localhost:8080

app.OnBeforeServe().Add(func(e *core.ServeEvent) error {
    e.Router.POST("/comment",

      //handler
      func(c echo.Context) error {
          return c.NoContent(http.StatusCreated)
      },

      //middlewares
      apis.ActivityLogger(app),
      apis.RequireRecordAuth(),
    )
    return nil
})

Client Code

import PocketBase from "pocketbase";

const pb = new PocketBase("http://127.0.0.1:8080");
// code to auth user
// ...

await pb.send("/comment", {
  // for all possible options check
  // https://developer.mozilla.org/en-US/docs/Web/API/fetch#options
});

Migrations

ls -al migrations/
Permissions  User   Group  Date Modified Name
.rw-r--r--   haseeb haseeb  2 Apr 22:52  1680445294_created_posts.go
.rw-r--r--   haseeb haseeb  2 Apr 22:52  1680445383_created_comments.go
.rw-r--r--   haseeb haseeb  2 Apr 22:52  1680445466_updated_comments.go
.rw-r--r--   haseeb haseeb  2 Apr 22:52  1680445481_updated_posts.go

// main.go
package main

import (
    "log"

    "github.com/pocketbase/pocketbase"
    "github.com/pocketbase/pocketbase/plugins/migratecmd"

    // you must have have at least one
    // .go migration file in the "migrations" directory
    _ "gitlab.com/hmajid2301/talks/.../migrations"
)

func main() {
  app := pocketbase.New()

  migratecmd.MustRegister(
    app,
    app.RootCmd,
    &migratecmd.Options{
      // auto creates migration files
      // when making collection changes
      Automigrate: true,
  })

  // ...
}

What is WAL Mode?

Why use WAL Mode?

• Is significantly faster in most scenarios.
• WAL uses many fewer fsync() operations
• Provides more concurrency as a writer does not block readers.

Dockerfile

FROM golang:1.20-alpine as builder

WORKDIR /build
RUN apk update && apk upgrade && \
	apk add --no-cache ca-certificates && \
	update-ca-certificates

COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o app main.go

FROM scratch
COPY --from=builder /build/app .
COPY --from=builder /etc/ssl/certs/ca-certificates.crt \
                    /etc/ssl/certs/

ENTRYPOINT [ "./app" ]
CMD ["serve", "--http=0.0.0.0:8080"]

fly.io

# fly.toml
app = "example"
kill_signal = "SIGINT"
kill_timeout = 5
processes = []

[build]
dockerfile = "Dockerfile"

[env]
ENV = "production"

[experimental]
allowed_public_ports = []
auto_rollback = true
enable_consul = true

[[services]]
http_checks = []
internal_port = 8080
processes = ["app"]
protocol = "tcp"
script_checks = []

[services.concurrency]
hard_limit = 25
soft_limit = 20
type = "connections"

[[services.ports]]
force_https = true
handlers = ["http"]
port = 80

[[services.ports]]
handlers = ["tls", "http"]
port = 443

[[services.tcp_checks]]
grace_period = "1s"
interval = "15s"
restart_limit = 0
timeout = "2s"

[mounts]
destination = "/pb_data"
source = "pb_data"

fly deploy

Gitlab CI

deploy:
  stage: deploy
  only:
    - main
  image: docker
  services:
    - docker:dind
  before_script:
    - apk add curl
    - curl -L https://fly.io/install.sh | sh
  script:
    - fly deploy

Caveats

• Need to self-host
  • PocketHost
• Does not have a stable API yet
• Can only scale vertically
  • LiteFS