diff --git a/devuser_guide/content/dev_guide/onboarding/initial.md b/devuser_guide/content/dev_guide/onboarding/initial.md
index b7de378e20..534006795f 100644
--- a/devuser_guide/content/dev_guide/onboarding/initial.md
+++ b/devuser_guide/content/dev_guide/onboarding/initial.md
@@ -14,9 +14,16 @@ toc: true
 
 ## Disclaimer
 
+key source file: [`ui/onboarding/Intro.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/Intro.qml#L9)
 
 ## First Time
 
+key source file: [`ui/onboarding/KeysMain.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/KeysMain.qml#L8)
+
+key source file: [`ui/main.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/main.qml#L357)
+
+the screens change using `applicationWindow.navigateTo("GenKey")`
 
 ## With Existing Accounts
 
+see [Login](../login)
diff --git a/devuser_guide/content/dev_guide/onboarding/login.md b/devuser_guide/content/dev_guide/onboarding/login.md
index 8f2e60647d..033789ff29 100644
--- a/devuser_guide/content/dev_guide/onboarding/login.md
+++ b/devuser_guide/content/dev_guide/onboarding/login.md
@@ -12,6 +12,40 @@ menu:
 toc: true
 ---
 
+key source file: [`ui/onboarding/Login.qml`]()
+
+## login process
+
+key source file: [`ui/onboarding/Login.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/Login.qml#L161)
+
+key source file: [`src/app/login/view.nim`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/app/login/view.nim#L102)
+
+key source file: [`src/status/accounts.nim`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/status/accounts.nim#L29)
+
+key source file: [`src/status/libstatus/accounts.nim`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/status/libstatus/accounts.nim#L201)
+
+The view will call `loginModel.login(password)`, the account to login is previously set by calling `loginModel.setCurrentAccount(index)`
+
 ## multiple accounts
 
+key source file: [`ui/onboarding/Login.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/Login.qml#L109)
+
+key source file: [`ui/onboarding/Login/SelectAnotherAccountModal.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/Login/SelectAnotherAccountModal.qml#L7)
+
+key source file: [`ui/onboarding/Login/SelectAnotherAccountModal.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/Login/SelectAnotherAccountModal.qml#L7)
+
+key source file: [`src/app/login/view.nim`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/app/login/view.nim#L19)
+
+key source file: [`src/app/login/core.nim`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/app/login/core.nim#L36)
+
+key source file: [`src/status/accounts.nim`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/status/accounts.nim#L26)
+
+key source file: [`src/status/libstatus/accounts.nim`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/status/libstatus/accounts.nim#L77)
+
+The account list is given by `loginModel` which is a QAbstractList, the accounts are filled in [login/core.nim](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/src/app/login/core.nim#L36)
+
 ## with only 1 account
+
+key source file: [`ui/onboarding/Login.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/Login.qml#L111)
+
+key source file: [`ui/onboarding/Login/ConfirmAddExistingKeyModal.qml`](https://github.com/status-im/status-desktop/blob/65a0cfbcd30eb7bde4e24cdb1680b3e03d8b1992/ui/onboarding/Login/ConfirmAddExistingKeyModal.qml#L7)