Socialize

Socialize is an organization-owned, 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

For preprod deployment, configure the POSTGRES_PASSWORD, RESEND_API_KEY, RESEND_FROM_EMAIL, and JWT_SIGNING_KEY Gitea secrets. The deploy workflow writes the remote .env file before running the server deploy script.

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.

1.9 KiB Raw Blame History