🔐 WeKan — Login System Overview

This document provides a detailed overview of WeKan’s login and authentication system, covering client-side UI, server-side logic, external authentication methods, and potential upgrade paths.

🖥️ Login Web UI

WeKan's login interface is implemented using a combination of:

• layouts.jade – Login HTML structure
• layouts.js – Login logic and interactivity
• layouts.css – Styling and layout

📁 Source: client/components/main

⚙️ Server-Side Authentication

Server-side login functionality is handled in:

• server/authentication.js

Other related configurations:

• 🔧 Account config: config/accounts.js
• 📨 Sign-up invitations: models/settings.js#L275
• 👤 User creation logic: models/users.js#L1339

👥 Meteor User Accounts

WeKan utilizes Meteor’s accounts system. Relevant resources:

• 📚 Meteor 2.x Accounts Docs: v2-docs.meteor.com/api/accounts
• 🔍 Meteor Packages:
• packages
• versions
• 📦 Meteor 2.14 core packages: Meteor 2.14 packages

🔐 External Authentication (OIDC, LDAP, etc.)

WeKan supports external authentication methods via internal packages.

📁 See packages/ for: - OpenID Connect (OIDC) - LDAP - OAuth and other integrations

📦 NPM & AtmosphereJS Dependencies

• 🔗 package.json: Dependencies list
• 🧩 WekanTeam scoped NPM packages: @wekanteam on npm
• ☁️ AtmosphereJS Meteor packages: atmospherejs.com

🚧 Meteor Version & Upgrade Notes

• 📌 Current Version: Meteor 2.14
• .meteor/release
• 🔧 Maintained with only critical fixes until ~Summer 2025
• 🚀 Migration to Meteor 3 or a new framework is under consideration

📘 Meteor 3 API: docs.meteor.com/api/accounts

🧪 Prototypes & Examples

🐘 PHP Prototype Sign-Up

Used in experimental versions:

• Step 1: sign-up1.php
• Step 2: sign-up2.php
• Main entry: index.php#L72-L83

🎨 WeKan Studio Prototype

Sign-up logic in the WeKan Studio version:

• signUp.fmt

📎 Future Considerations

• Upgrading to Meteor 3.x
• Refactoring frontend logic to fix translation rendering order
• Exploring simplified authentication systems in future prototypes

🔗 Project Links

• 🔧 Main Repo: github.com/wekan/wekan
• 🌐 Website: wekan.github.io
• 📚 Documentation: Wekan Wiki