This commit is contained in:
2026-01-28 12:58:02 +00:00
parent f516ba6c8b
commit b1b9386b3c

View File

@@ -1,81 +1,8 @@
# Kickback
# Reactivity issue repro
Unified web application for music library management using SvelteKit and beets.
## Steps
## Development Setup
### Prerequisites
- Node.js 24+
- Python 3.11+
- pnpm
- uv (Python package manager)
### Installation
1. Install dependencies:
```bash
pnpm install
uv pip install -r requirements.txt
```
2. Start development server:
```bash
pnpm dev
```
The app will be available at http://localhost:5173
## Beets Integration
The application uses beets for music library management. All beets commands are called via `src/lib/beets.ts` helper functions.
### Local Development
Beets is installed locally via `uv`. The CLI is available for use in SvelteKit actions.
### Production Build
```bash
# Build Docker image
pnpm docker:build
# Start container
pnpm docker:run
```
The unified container runs both SvelteKit and beets with data persisted to `.data/` and `.appdata/`.
## Project Structure
```
kickback/
├── src/ # SvelteKit application source
│ └── lib/
│ └── beets.ts # Beets CLI helpers
├── config/
│ └── beets.yaml # Beets configuration
├── .data/ # Music library (gitignored)
├── .appdata/ # Beets state (gitignored)
└── docker-compose.yml
```
## Docker
The production Docker image packages:
- Python 3.11 with beets installed via uv
- Node 24 with SvelteKit application
- Beets configuration and data volume mounts
## Commands
- `pnpm dev` - Start dev server
- `pnpm build` - Build for production
- `pnpm test` - Run tests
- `pnpm lint` - Lint code
- `pnpm format` - Format code
- `pnpm docker:build` - Build Docker image
- `pnpm docker:run` - Run Docker container via docker-compose
- 1. Install the dependencies with `pnpm install`
- 2. Start the development server using `pnpm dev`
- 3. Navigate to `http://localhost:5173`
- 4. Type in `hi` in the input field