Quill #

A native Bluesky client for iPhone, iPhone Duo and iPad (Android to follow).

See AGENTS.md for layout, commands and conventions.

Quick Start #

brew install xcodegen
make test
make ios-generate
open apps/ios/Quill.xcodeproj

Local API Keys #

To enable GIF search, create apps/ios/Config/Local.xcconfig with KLIPY_API_KEY = your_key. This optional file is ignored by Git and loaded by both Debug and Release builds. Never put provider credentials in project.yml.

OAuth Deployment #

The production OAuth metadata service is hosted on Railway at https://quillapp.at. Its client ID is https://quillapp.at/client-metadata.json, and the native callback is at.quillapp:/oauth/callback. See the worker guide for runtime configuration.

Deploy the worker independently of the iOS app:

railway up services/oauth-worker --path-as-root \
  --project 90c005fd-c175-4739-8c48-e8bfe061704e \
  --environment da2abdc2-64d4-4b99-b663-19783844bd3e \
  --service 64137a97-126f-46d1-9f6b-9427b2122c81 \
  --ci -m "Describe the worker change"
python3 scripts/verify-oauth-worker.py

DNS is managed through the Marque TUI. The apex CNAME targets hi2dj4fb.up.railway.app (flattened by Marque), with TTL 300. _railway-verify holds Railway's ownership-verification TXT record. The service uses port 8080, /healthz, PUBLIC_URL=https://quillapp.at, APPLE_TEAM_ID=G39TU2R26A, and APPLE_BUNDLE_ID=tech.stygian.quill. It is a public native OAuth client; do not configure a shared client signing key.

The deployment smoke check verifies the public worker contract. Complete OAuth acceptance also requires signing in through the app, returning from the browser, and force-quitting/relaunching to verify the securely stored session.