Kyle Isom 9077117e74 Implement Phase 0+1: project setup, config, database, migrations
- Go module, Makefile, .golangci.yaml, .gitignore, example config
- TOML config loading with validation
- SQLite database with WAL, foreign keys, busy timeout
- Schema migrations: users, webauthn_credentials, notebooks, pages,
  strokes, share_links with indexes and cascading deletes
- 4 tests: open+migrate, idempotent, foreign keys, cascade delete

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-24 19:47:38 -07:00

eng-pad-server

Read-only sync and web viewer for eng-pad engineering notebooks.

The Android app pushes complete notebooks to this server via gRPC. The server stores them and serves read-only views through a web UI with SVG rendering. Shareable links allow unauthenticated access to specific notebooks.

Features

  • gRPC sync: receive notebook data from the Android app over TLS
  • Web viewer: browse notebooks, view pages as SVG, export JPG/PDF
  • Authentication: password (Argon2id) + FIDO2/U2F security keys
  • Shareable links: token-based URLs with optional expiry

Quick Start

# Build
make eng-pad-server

# Generate example config
cp eng-pad-server.toml.example /srv/eng-pad-server/eng-pad-server.toml
# Edit configuration (TLS certs, database path, etc.)

# Initialize (creates database, prompts for admin user)
./eng-pad-server init

# Run
./eng-pad-server server

Build

make all          # vet → lint → test → build
make test         # run tests
make lint         # golangci-lint
make proto        # regenerate gRPC code from .proto files
make proto-lint   # buf lint + breaking change detection

Documentation

License

Private. All rights reserved.

Description
No description provided
Readme 375 KiB
Languages
Go 87.1%
HTML 11%
Shell 0.9%
Makefile 0.6%
Dockerfile 0.4%