Socialize

Socialize is a workspace-based workflow application for social media content review, revision, approval, and publication readiness.

It is not a public social network. The product is for internal teams, providers, and client approvers coordinating content work before publication.

Monorepo

• Backend: .NET 10 Web API in backend/src/Socialize.Api
• Backend tests: backend/tests/Socialize.Tests
• Frontend: Vue 3 + Vite + Vuetify + Pinia in frontend
• API contract: OpenAPI snapshot in shared/openapi
• Deployment: Docker Compose + Caddy
• Agentic workflow: specs, task files, and prompt templates under docs

Local Development

Terminal 1:

./scripts/start-infrastructure.sh
./scripts/dev-backend.sh

Terminal 2:

./scripts/dev-frontend.sh

Frontend:

http://localhost:5173
http://<this-machine-lan-ip>:5173

Backend:

http://localhost:5080
http://<this-machine-lan-ip>:5080

Swagger UI:

http://localhost:5080/api

Update Frontend API Types

The backend must be running first.

./scripts/update-openapi.sh

This writes:

shared/openapi/openapi.json
frontend/src/api/schema.d.ts

Docker Compose

docker compose up --build

Then open:

http://localhost:8080
http://<this-machine-lan-ip>:8080

Solution

dotnet build backend/Socialize.slnx
dotnet test backend/Socialize.slnx

Frontend Build

cd frontend
npm run build

Agentic Workflow

Start here:

docs/AGENTIC_WORKFLOW.md

Use feature specs, task files, and prompt templates instead of asking agents to work from vague chat history.