Skip to content

justEstif/specto

Repository files navigation

Specto

Personal media consumption analysis dashboard. Aggregates your digital media history across platforms (Spotify, YouTube, Netflix, etc.), normalizes it into a unified schema, and surfaces insights into what you consume, how much, and what patterns dominate your attention.

See docs/MVP.md for the full product scope.

Tech Stack

Prerequisites

Quick Start

1. Install Tools

mise install

2. Start PostgreSQL

docker-compose up -d

3. Setup Project

mise run setup

4. Start Development

# Terminal 1 — watch templ files (optional)
mise run templ

# Terminal 2 — dev server with live reload
mise run dev

5. Visit Application

Open http://localhost:3000

Available Tasks

Run mise tasks to see all available tasks:

Task Description
mise run dev Start development server with live reload
mise run templ Generate templ files
mise run db-migrate Run database migrations
mise run db-rollback Rollback last migration
mise run sqlc Generate type-safe SQL code
mise run setup Complete project setup
mise run build Build production binary
mise run api-test Run httpyac API tests

Project Structure

.
├── cmd/web/              # Application entry point
├── internal/
│   ├── handlers/         # HTTP handlers
│   ├── middleware/        # Custom middleware
│   └── database/         # Database connection & queries
├── components/           # Templ templates
├── migrations/           # Database migrations
├── http/                 # httpyac API request files
│   └── environments/     # Environment configs
├── docs/                 # Project documentation
├── mise.toml             # Tool & task configuration
└── docker-compose.yml    # PostgreSQL setup

Documentation

License

MIT

About

Personal media consumption analysis dashboard. Aggregates your digital media history across platforms, normalizes it into a unified schema, and surfaces insights into what you consume.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors