PDS Status - Tophhie Social#

A real-time status dashboard for monitoring the Tophhie Social Personal Data Server (PDS), built with SvelteKit and the AT Protocol.

Overview#

This application provides a comprehensive status page for the Tophhie Social PDS instance, displaying server health metrics, account information, storage usage statistics, and more. It integrates with both the AT Protocol APIs and the Tophhie Cloud API to provide detailed insights into the server's operation.

Features#

• Real-time Service Monitoring

  • PDS version and health status
  • Server DID (Decentralized Identifier)
  • Account count and registration status
  • Invite code requirements

• Statistics Dashboard

  • Total posts published this year
  • Cloudflare R2 blob storage usage
  • Heatmap data visualization

• Account Management

  • List all DIDs registered on the server
  • Resolve handles from DIDs using PLC directory
  • Direct links to PLC directory entries
  • Display available user domains

• Server Information

  • Contact information
  • Privacy policy and terms of service links
  • Available user domains

Tech Stack#

• Framework: SvelteKit with Svelte 5

• Language: TypeScript

• Styling: TailwindCSS 4

• APIs:

  • @atproto/api - AT Protocol client
  • Tophhie Cloud API
  • PLC Directory API

• Build Tool: Vite

• Adapter: Static adapter for deployment

Prerequisites#

• Node.js 18.x or higher
• npm, pnpm, or yarn

Installation#

1. Clone the repository:

git clone <git@github.com:Tophhie/pds-status.git>
cd pds-status-tophhie

1. Install dependencies:

npm install

1. Configure the application by editing src/config.ts:

export class Config {
  static readonly PDS_URL: string = "https://your-pds-url.com";
  static readonly TOPHHIE_CLOUD_API_URL: string = "https://your-api-url.com";
}

Development#

Start the development server:

npm run dev

The application will be available at http://localhost:5173 (or another port if 5173 is in use).

Development with auto-reload#

npm run dev -- --open

This will start the server and automatically open the app in your default browser.

Building for Production#

Create a production build:

npm run build

The static output will be generated in the dist directory, ready for deployment.

Preview the production build locally:

npm run preview

Available Scripts#

• npm run dev - Start development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run check - Run TypeScript and Svelte checks
• npm run check:watch - Run checks in watch mode
• npm run format - Format code with Prettier
• npm run lint - Lint and check code formatting

Project Structure#

pds-status-tophhie/
├── src/
│   ├── lib/
│   │   ├── api.ts           # API functions for PDS and cloud services
│   │   └── assets/          # Static assets (favicon, etc.)
│   ├── routes/
│   │   ├── +layout.svelte   # Root layout component
│   │   └── +page.svelte     # Main status page
│   ├── app.css              # Global styles
│   ├── app.html             # HTML template
│   └── config.ts            # Application configuration
├── static/                   # Static files
├── svelte.config.js         # SvelteKit configuration
├── tailwind.config.cjs      # TailwindCSS configuration
├── tsconfig.json            # TypeScript configuration
└── vite.config.ts           # Vite configuration

API Integration#

PDS Endpoints#

The application queries the following PDS endpoints:

• com.atproto.sync.listRepos - List all repositories (accounts)
• _health - Health check endpoint
• com.atproto.server.describeServer - Server description and metadata

External APIs#

• PLC Directory (https://plc.directory/) - Resolve DIDs to handles
• Tophhie Cloud API - Custom endpoints for:
  • Bluesky post heatmap data
  • R2 blob storage usage statistics

Configuration#

The main configuration is located in src/config.ts:

export class Config {
  static readonly PDS_URL: string = "https://tophhie.social";
  static readonly TOPHHIE_CLOUD_API_URL: string = "https://api.tophhie.cloud";
}

Update these values to point to your own PDS instance and API endpoints.

Deployment#

This project is configured with the static adapter for deployment to static hosting services:

Supported Platforms#

• Vercel
• Netlify
• GitHub Pages
• Cloudflare Pages
• Any static file host

The build output in the dist directory contains all necessary files for deployment.

Contributing#

Contributions are welcome! Please feel free to submit a Pull Request.

License#

MIT License

Copyright (c) 2025 Chris Greenacre

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Acknowledgments#

• Built with SvelteKit
• Uses the AT Protocol for decentralized social networking
• Powered by Bluesky infrastructure

Support#

For issues or questions about the Tophhie Social PDS, please contact the server administrator at the email provided in the status page.