# slice

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

## Quick Start

```bash
# 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

```bash
# 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](https://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