In your Val.town project settings, add:

• BASE_URL: Your val.town URL (e.g., https://kipclip-yourname.val.town)

That's it! Val.town provides SQLite automatically - no external database setup needed.

# Run quality checks
deno task quality

# Deploy to Val.town
deno task deploy

1. Visit your Val.town URL
2. Enter your AT Protocol handle (e.g., yourname.bsky.social)
3. Complete OAuth authorization on your PDS
4. Verify you're redirected back and logged in

1. Click "Add Bookmark"
2. Enter a URL (e.g., https://github.com)
3. Verify the bookmark appears with the page title
4. Test deletion

Use the AT Protocol API to verify bookmarks are saved:

# List your bookmarks
curl https://bsky.social/xrpc/com.atproto.repo.listRecords \
  -G \
  --data-urlencode "repo=yourname.bsky.social" \
  --data-urlencode "collection=community.lexicon.bookmarks.bookmark"

• Check BASE_URL matches your Val.town URL exactly
• Check browser console for error messages
• Verify you're using the correct AT Protocol handle format

• Check the target URL is accessible
• Verify it returns HTML content
• Check Val.town logs for fetch errors

In Val.town dashboard, check the "Logs" tab for your val.

Val.town provides a SQLite database automatically. The OAuth sessions are stored in the iron_session_storage table.

# Pull latest changes
git pull

# Run quality checks
deno task quality

# Deploy
deno task deploy

• OAuth tokens are stored securely in Val.town SQLite with iron-session encryption
• Sessions expire after 30 days
• Bookmarks are stored on user's PDS, not in appview database
• No sensitive data is logged
• All OAuth flows follow AT Protocol security best practices