Skip to content
@crydensync

CrydenSync

Open-source tools for developers to own authentication, identity, and user data.

CrydenSync 🔐

Open-source, embeddable authentication infrastructure for modern developers

GitHub Org Go Reference License: MIT Twitter Follow


🎯 What is CrydenSync?

CrydenSync is an embeddable authentication engine that gives developers a standard, reusable auth system they control.

Think of it as: import "github.com/crydensync/cryden/v2" → production-ready auth in minutes.

No vendor lock-in. No cloud dependency. Your users belong to YOU.


🌍 Built for Africa, Ready for the World

🇳🇬 🇰🇪 🇿🇦 🇬🇭 🇪🇬 🇹🇿 🇺🇬 🇸🇳 🇷🇼 🇳🇦 🇿🇲 🇨🇲 🇪🇹 🇲🇦 🇩🇿

African developers are our priority.
Offline-first storage is on the roadmap — see below.
Affordable to run, self-hosted, no forced cloud dependency.
Your data, your rules, your continent.

🚀 Our Projects

Project Description Status
cryden Core auth engine ✅ v2.0.0 — full rewrite, tested, Postgres-backed
typebook Reference app (notes, full auth flow) ✅ Built
api Self-hosted HTTP wrapper ✅ Built, tested end-to-end
csax Admin CLI ✅ Built — users, sessions, audit, stats, migrations
sdk-js JavaScript/TypeScript SDK ✅ Built, tested — not yet published to npm
sdk-py Python SDK 📅 Planned
docs Documentation site 🚧 In progress

Why v2, not v1? The original v1 had real, since-fixed security issues (predictable session IDs, a hardcoded default JWT secret, broken rate limiting). v2 is a ground-up rewrite that fixes these at the architecture level — see the design decisions doc for the full story.


✨ What Makes CrydenSync Different?

👑 Own Your Users Your users belong to you, not us. User data stays in your own Postgres database, self-hosted, from the first line of code.

🔌 Framework Agnostic No HTTP, no cookies, no headers baked in. Pure logic you can wrap with a CLI, an HTTP API, or embed directly in your Go app.

🕵️ Zero Telemetry The engine never phones home. Logs, audit events, and email delivery all go wherever you configure — nothing leaves your infrastructure by default.

🌍 African-First, Global-Ready Built with real-world constraints in mind (unstable connectivity, affordable infrastructure) — self-hosting anywhere, including on modest hardware, is a first-class use case, not an afterthought. True offline-first local storage (e.g. SQLite) is a real, planned roadmap item, not shipped yet.


📦 Quick Start

import (
	"context"

	"github.com/crydensync/cryden/v2"
	"github.com/crydensync/cryden/v2/store/postgres"
)

func main() {
	db, _ := sql.Open("postgres", os.Getenv("DATABASE_URL"))

	engine, _ := cryden.New(cryden.Config{
		JWTSecret: os.Getenv("JWT_SECRET"),
		Users:     postgres.NewUserStore(db),
		Sessions:  postgres.NewSessionStore(db),
		Audit:     postgres.NewAuditStore(db),
	})
	ctx := context.Background()

	// Sign up
	user, _ := cryden.SignUp(ctx, engine, "devray@example.com", "Pass@2026", callerIP)

	// Login
	tokens, _ := cryden.Login(ctx, engine, "devray@example.com", "Pass@2026", callerIP, userAgent)

	// Protect routes
	userID, _ := cryden.VerifyToken(engine, tokens.AccessToken)
}

No database yet? Swap in store/memory for a zero-setup version to try it out.

📚 Get Started →


🗺️ Roadmap

Focus Status
Core engine — auth, sessions, token rotation with reuse detection, account lockout, email verification ✅ Shipped (v2.0.0)
Admin CLI, self-hosted HTTP API, JS SDK ✅ Built
Documentation site 🚧 In progress
OAuth (Google, GitHub), Python SDK, React SDK layer 📅 Next
AI-assisted admin tooling (natural-language queries, audit review — human-confirmed actions only, never automatic) 📅 Planned
A second storage backend (e.g. SQLite, for true offline-first use) 📅 Deliberately deferred, not yet scoped

A hosted, multi-tenant CrydenSync Cloud is explicitly not on the current roadmap — every deployment is self-hosted, by design.


🤝 We Need You!

Current Open Roles

Role Need
Go Developer Core engine, CLI, API
Security Reviewer The engine has extensive automated tests but no external security audit yet — this is genuinely needed
Frontend/SDK Developer JS SDK polish, Python SDK, React hooks layer
Documentation Writer Guides, examples, real-world tutorials
Test Engineer More integration coverage, especially around edge cases
Junior Dev Good-first-issues, learn by contributing to a real project

How to Join

  1. Read CONTRIBUTING.md
  2. Check open issues
  3. Join the WhatsApp group or Discord
  4. Introduce yourself

First-Time Contributors Welcome

Look for issues labeled good-first-issue, help-wanted, or documentation. We'll help you land your first PR.


💬 Community

African developers: WhatsApp is our primary home.

Type Link Purpose
WhatsApp Channel Join 📢 Announcements only (1-way)
WhatsApp Group 💬 Discussions, help, contributions (2-way)
Discord Join 🎙️ Voice calls, technical deep dives
GitHub Discussions 📝 Long-form technical discussions
X / Twitter @CrydenSync Updates
  • Just want updates? → Join the Channel
  • Want to ask questions? → Join the Group
  • Want voice calls? → Discord
  • Want to contribute code? → GitHub Discussions

Direct: Ask on WhatsApp

Built in Nigeria. For African developers. Welcoming the world.


📄 License

All CrydenSync projects are open source under the MIT License.

Free forever. Open always. Own your users.

Built with ❤️ in Nigeria, for developers everywhere.

Own your users, not vendor lock-in.

Pinned Loading

  1. typebook typebook Public

    A minimalist note-taking app demonstrating CrydenSync auth, and session management.

    Go 16 1

  2. cryden cryden Public

    Open-source, embeddable authentication for modern developers — vendor-free.

    Go 21 3

Repositories

Showing 9 of 9 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…