Skip to content

About

Sifa project coordination and issue tracking

Resources

Code of conduct

Contributing

Security policy

Stars

26 stars

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

Repository files navigation

Sifa Logo

Sifa Workspace

Project coordination and issue tracking for the Sifa professional network.

Status: Alpha


Overview

Central coordination repository for the Sifa professional network. To report a bug or request a feature, send feedback. Contains project-level documentation, architecture decisions, and cross-repo coordination.


Architecture

User's PDS (data lives here)
├── id.sifa.profile.*     Professional profile (positions, education, skills)
├── id.sifa.graph.follow   One-way professional follows
├── id.sifa.endorsement    Skill endorsements (mutual confirmation)
└── app.bsky.*             Social data (imported read-only)

Sifa AppView (reads and aggregates)
├── sifa-api               Fastify backend, Jetstream consumer, OAuth provider
├── sifa-web               Next.js frontend, SSR profile pages
└── sifa-deploy            Docker Compose + Caddy reverse proxy

Repositories

Repository Visibility Description
sifa-api private AppView backend (Fastify, AT Protocol)
sifa-web private Frontend (Next.js, React, TailwindCSS)
sifa-deploy private Docker Compose + Caddy deployment config
sifa-sdk public Client library for the AppView, on npm as @singi-labs/sifa-sdk (MIT)
sifa-lexicons public AT Protocol professional profile schemas, id.sifa.* (MIT)
sifa-docs public Documentation site (Fumadocs) — docs.sifa.id
sifa-page public Self-hostable personal site generated from a Sifa profile
sifa-page-renderer public Pure HTML renderer behind sifa-page, on npm as @singi-labs/sifa-page-renderer
sifa-workspace public This repo — project coordination and issue tracking

Dependency graph

scripts/dep-graph.mjs maps how the sifa-* repos depend on each other. It reads each repo's package.json, resolves @singi-labs/* deps to sibling repos, and reports edges, orphans, cycles, version drift, duplicate clones, and internal deps with no repo checked out locally. No dependencies, no state written, no network access.

# fetch first so origin/main is current, then read from the branch
# rather than from whatever happens to be checked out
git -C <each repo> fetch origin main
node scripts/dep-graph.mjs --root ~/Documents/Git --root ~/Git --ref origin/main
Flag Effect
--root <dir> Directory holding the repos; repeatable (default: parent of this repo)
--ref <git-ref> Read package.json from a git ref, e.g. origin/main, instead of the working tree
--prefix <str> Repo directory prefix to scan (default: sifa-)
--scope <scope> Package scope treated as internal (default: @singi-labs)
--json Machine-readable output
--mermaid Mermaid diagram for docs
--strict Exit 1 on drift, unresolved internal deps, or cycles

Two things worth knowing:

  • Pass --ref origin/main. Reading the working tree reports whatever a local clone happens to be at, which on a machine with stale checkouts produces drift numbers that are simply wrong.
  • Pass every root. Repos are not all under one directory on every machine. Clones are de-duplicated by their origin remote rather than directory name, so a second clone under a different name is reported instead of appearing as a phantom project with phantom edges.

Use --strict in CI to catch SDK version drift before it reaches a release.


Tech Stack

  • Runtime: Node.js 26 / TypeScript (strict)
  • API: Fastify 5 / Drizzle ORM / PostgreSQL 17 / Valkey 8
  • Frontend: Next.js 16 / React 19 / TailwindCSS / shadcn/ui
  • Protocol: @atproto/oauth-client-node / Jetstream WebSocket / PDS applyWrites
  • i18n: next-intl (English, Dutch, German, French, Spanish, Portuguese)
  • Deploy: Docker / GitHub Actions / Caddy


Part of Singi Labs

Sifa is built by Singi Labs, alongside Barazo (federated forum on AT Protocol). The two products share a flywheel: Barazo community participation builds verifiable professional track records that appear on Sifa profiles.


Community


License

The id.sifa.* lexicons are open source under the MIT license. See sifa-lexicons for details.


Made with ♥ in 🇪🇺 by Singi Labs

About

Sifa project coordination and issue tracking

Resources

Code of conduct

Contributing

Security policy

Stars

26 stars

Watchers

0 watching

Forks

Used by

Contributors

Languages