atproto-nix-tracker#

A Deno SSR web application with AT Protocol integration, built with Preact, HTMX, and OAuth authentication.

Quick Start#

# Start the development server
deno task dev

Visit your app at http://localhost:8080

Note: Your slice and OAuth credentials were automatically configured during project creation. The .env file is already set up with your credentials.

Features#

• 🔐 OAuth Authentication with PKCE flow
• ⚡ Server-Side Rendering with Preact
• 🎯 Interactive UI with HTMX
• 🎨 Styling with Tailwind CSS
• 🗄️ Session Management with SQLite
• 🔄 Auto Token Refresh
• 🏗️ Feature-Based Architecture

Development#

# Start development server with hot reload
deno task dev

# Start production server
deno task start

# Format code
deno fmt

# Check types
deno check src/**/*.ts src/**/*.tsx

Project Structure#

slices.json              # Slices configuration file
lexicons/                # AT Protocol lexicon definitions
src/
├── main.ts              # Server entry point
├── config.ts            # OAuth & session configuration
├── generated_client.ts  # Generated TypeScript client from lexicons
├── routes/              # Route definitions
├── features/            # Feature modules
│   └── auth/           # Authentication
├── shared/fragments/    # Reusable UI components
└── utils/              # Utility functions

OAuth Setup#

Your OAuth application was automatically created during project initialization with:

• Client ID & Secret: Already configured in .env
• Redirect URI: http://localhost:8080/oauth/callback
• Slice: Automatically created and linked

To manage your OAuth clients or create additional ones:

1. Visit Slices Network
2. Use the slices login CLI command

Documentation#

• CLAUDE.md - Architecture guide for AI assistance
• Feature directories contain handlers and templates
• Components use Preact with server-side rendering
• HTMX provides interactive behavior without page reloads

License#

MIT