jaballadares
README.md

iOS Share Sheet Backend

A secure backend system for iOS share sheet shortcuts with WebAuthn authentication and content management.

Features

  • WebAuthn Authentication: Secure passwordless authentication
  • iOS Share Sheet Integration: Accept text, images, and web URLs from iOS shortcuts
  • User Content Management: Timestamped content storage per user
  • Bearer Token API: Secure API access for shortcuts
  • Admin Interface: User and content management
  • Setup Workflow: Guided shortcut configuration

Project Structure

├── backend/
│   ├── database/
│   │   ├── migrations.ts    # Database schema
│   │   └── queries.ts       # Database operations
│   ├── routes/
│   │   ├── auth.ts         # WebAuthn authentication
│   │   ├── content.ts      # Content management
│   │   ├── admin.ts        # Admin operations
│   │   └── static.ts       # Static file serving
│   └── index.ts            # Main entry point
├── frontend/
│   ├── components/
│   │   ├── App.tsx         # Main application
│   │   ├── Auth.tsx        # Authentication UI
│   │   ├── Dashboard.tsx   # User dashboard
│   │   ├── Admin.tsx       # Admin interface
│   │   └── Setup.tsx       # Shortcut setup guide
│   ├── index.html          # Main HTML template
│   └── index.tsx           # Frontend entry point
├── shared/
│   └── types.ts            # Shared TypeScript types
└── README.md

API Endpoints

Authentication

  • POST /api/auth/register-start - Start WebAuthn registration
  • POST /api/auth/register-finish - Complete WebAuthn registration
  • POST /api/auth/login-start - Start WebAuthn login
  • POST /api/auth/login-finish - Complete WebAuthn login
  • POST /api/auth/token - Generate bearer token for shortcuts

Content Management

  • POST /api/content - Add content via shortcut (requires bearer token)
  • GET /api/content - Get user's content (requires authentication)
  • DELETE /api/content/:id - Delete content item

Admin (requires admin role)

  • GET /api/admin/users - List all users
  • GET /api/admin/content - List all content
  • POST /api/admin/users/:id/admin - Grant admin privileges

iOS Shortcut Setup

  1. Create Account: Visit the web interface and register with WebAuthn
  2. Generate Token: Create a bearer token for your shortcuts
  3. Install Shortcut: Use the provided shortcut template
  4. Configure Token: Add your bearer token to the shortcut
  5. Test: Share content from any iOS app

Environment Variables

  • ADMIN_EMAIL - Email address for the initial admin user

Getting Started

  1. Deploy this val to Val Town
  2. Visit the web interface to create your account
  3. Follow the shortcut setup guide
  4. Start sharing content from iOS!