eBay Store Manager (droplet-next)

A web app for small UK eBay sellers to manage listings and inventory using Seller Hub CSV exports/imports and manual edits.

Tech Stack

• Framework: ASP.NET Core 8 + Blazor Server
• Database: PostgreSQL + EF Core (migrations)
• CSV: CsvHelper
• Auth: ASP.NET Core Identity (email/password)
• CSS: Tailwind CSS v4 (Yarn pipeline)
• Deployment: Docker + docker-compose

Getting Started

Prerequisites

• .NET 8 SDK
• Node.js and Yarn
• Docker and Docker Compose

Local Development

1. Install dependencies:

   cd src/Droplet.Web
   dotnet restore
   cd ../Burrow/Burrow.Auth
   yarn install
   

2. Start dependent services (database):

   docker compose up -d
   

   This starts PostgreSQL on localhost:5432.

3. Configure the database connection string:

   The appsettings.json contains placeholder values. Set the connection string for local development using .NET user-secrets:

   cd src/Droplet.Web
   dotnet user-secrets set "ConnectionStrings:DefaultConnection" "Host=localhost;Port=5432;Database=droplet_next;Username=your_user;Password=your_password"
   

   Alternatively, set the ConnectionStrings__DefaultConnection environment variable.

4. Run database migrations:

   cd src/Droplet.Web
   dotnet ef database update
   

5. Build CSS and run:

   cd src/Burrow/Burrow.Auth
   yarn css:build
   cd ../../Droplet.Web
   dotnet run
   

   Or, to watch for CSS changes during development:

   # Terminal 1
   cd src/Burrow/Burrow.Auth
   yarn css:watch
   # Terminal 2
   cd src/Droplet.Web
   dotnet run
   

   Note: Data-protection keys and email files are written to .temp/ inside the working directory by default. This directory is excluded from version control.

Running Tests

dotnet test

See docs/unit-testing.md for details on writing and running tests.

Docker (Production)

1. Copy .env.example to .env and set a strong POSTGRES_PASSWORD.

2. Run:

   docker compose up -d
   

   This starts the database. Build and run the application separately (e.g. via dotnet run or your CI/CD pipeline).

Documentation

• PRD — v1 Initiative
• ADR 0001 — Tech Stack
• Epics
• Configuring Email Providers
• Unit Testing