From dd19067f6009e72fccc329f9bcc24dac6090738e Mon Sep 17 00:00:00 2001
From: Jainil Prajapati <86187588+jaainil@users.noreply.github.com>
Date: Fri, 26 Sep 2025 08:06:48 +0530
Subject: [PATCH] feat: add Flatnotes blueprint with TOTP authentication (#387)

* feat: add Flatnotes blueprint with TOTP authentication

Introduces a new blueprint for deploying Flatnotes with TOTP-based 2FA, including compose, template, and metadata files.

* feat: add Flatnotes self-hosted markdown note-taking app
---
 blueprints/flatnotes-totp/docker-compose.yml |  23 +++++++++++
 blueprints/flatnotes-totp/image.png          | Bin 0 -> 4974 bytes
 blueprints/flatnotes-totp/template.toml      |  28 ++++++++++++++
 blueprints/flatnotes/docker-compose.yml      |  28 ++++++++++++++
 blueprints/flatnotes/image.png               | Bin 0 -> 4974 bytes
 blueprints/flatnotes/template.toml           |  32 ++++++++++++++++
 meta.json                                    |  38 +++++++++++++++++++
 7 files changed, 149 insertions(+)
 create mode 100644 blueprints/flatnotes-totp/docker-compose.yml
 create mode 100644 blueprints/flatnotes-totp/image.png
 create mode 100644 blueprints/flatnotes-totp/template.toml
 create mode 100644 blueprints/flatnotes/docker-compose.yml
 create mode 100644 blueprints/flatnotes/image.png
 create mode 100644 blueprints/flatnotes/template.toml

diff --git a/blueprints/flatnotes-totp/docker-compose.yml b/blueprints/flatnotes-totp/docker-compose.yml
new file mode 100644
index 00000000..c9d658b5
--- /dev/null
+++ b/blueprints/flatnotes-totp/docker-compose.yml
@@ -0,0 +1,23 @@
+version: "3.8"
+
+services:
+  flatnotes:
+    image: dullage/flatnotes:latest
+    restart: unless-stopped
+    environment:
+      PUID: ${PUID}
+      PGID: ${PGID}
+      FLATNOTES_AUTH_TYPE: "totp"
+      FLATNOTES_USERNAME: ${FLATNOTES_USERNAME}
+      FLATNOTES_PASSWORD: ${FLATNOTES_PASSWORD}
+      FLATNOTES_SECRET_KEY: ${FLATNOTES_SECRET_KEY}
+      FLATNOTES_TOTP_KEY: ${FLATNOTES_TOTP_KEY}
+      FLATNOTES_SESSION_EXPIRY_DAYS: ${FLATNOTES_SESSION_EXPIRY_DAYS}
+      FLATNOTES_PATH_PREFIX: ${FLATNOTES_PATH_PREFIX}
+    expose:
+      - 8080
+    volumes:
+      - flatnotes-data:/data
+
+volumes:
+  flatnotes-data: {}
diff --git a/blueprints/flatnotes-totp/image.png b/blueprints/flatnotes-totp/image.png
new file mode 100644
index 0000000000000000000000000000000000000000..3796c5868bd5055322ec054f9a2b7c2d6812b444
GIT binary patch
literal 4974
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

literal 0
HcmV?d00001

diff --git a/blueprints/flatnotes-totp/template.toml b/blueprints/flatnotes-totp/template.toml
new file mode 100644
index 00000000..8ce4bc9c
--- /dev/null
+++ b/blueprints/flatnotes-totp/template.toml
@@ -0,0 +1,28 @@
+[variables]
+main_domain = "${domain}"
+username = "${username}"
+password = "${password:16}"
+secret_key = "${password:32}"
+totp_key = "${password:32}"
+
+[config]
+[[config.domains]]
+serviceName = "flatnotes"
+port = 8080
+host = "${main_domain}"
+path = "/"
+
+[config.env]
+PUID = "1000"
+PGID = "1000"
+FLATNOTES_AUTH_TYPE = "totp"
+FLATNOTES_USERNAME = "${username}"
+FLATNOTES_PASSWORD = "${password}"
+FLATNOTES_SECRET_KEY = "${secret_key}"
+FLATNOTES_TOTP_KEY = "${totp_key}"
+FLATNOTES_SESSION_EXPIRY_DAYS = "30"
+FLATNOTES_PATH_PREFIX = ""
+
+[[config.mounts]]
+name = "flatnotes-data"
+mountPath = "/data"
diff --git a/blueprints/flatnotes/docker-compose.yml b/blueprints/flatnotes/docker-compose.yml
new file mode 100644
index 00000000..be5090f2
--- /dev/null
+++ b/blueprints/flatnotes/docker-compose.yml
@@ -0,0 +1,28 @@
+version: "3.8"
+
+services:
+  flatnotes:
+    image: dullage/flatnotes:latest
+    restart: unless-stopped
+    environment:
+      PUID: ${PUID}
+      PGID: ${PGID}
+      FLATNOTES_AUTH_TYPE: ${FLATNOTES_AUTH_TYPE}
+      FLATNOTES_USERNAME: ${FLATNOTES_USERNAME}
+      FLATNOTES_PASSWORD: ${FLATNOTES_PASSWORD}
+      FLATNOTES_SECRET_KEY: ${FLATNOTES_SECRET_KEY}
+      FLATNOTES_SESSION_EXPIRY_DAYS: ${FLATNOTES_SESSION_EXPIRY_DAYS}
+      FLATNOTES_TOTP_KEY: ${FLATNOTES_TOTP_KEY}
+      FLATNOTES_PATH_PREFIX: ${FLATNOTES_PATH_PREFIX}
+      FLATNOTES_QUICK_ACCESS_HIDE: ${FLATNOTES_QUICK_ACCESS_HIDE}
+      FLATNOTES_QUICK_ACCESS_TITLE: ${FLATNOTES_QUICK_ACCESS_TITLE}
+      FLATNOTES_QUICK_ACCESS_TERM: ${FLATNOTES_QUICK_ACCESS_TERM}
+      FLATNOTES_QUICK_ACCESS_SORT: ${FLATNOTES_QUICK_ACCESS_SORT}
+      FLATNOTES_QUICK_ACCESS_LIMIT: ${FLATNOTES_QUICK_ACCESS_LIMIT}
+    expose:
+      - 8080
+    volumes:
+      - flatnotes-data:/data
+
+volumes:
+  flatnotes-data: {}
diff --git a/blueprints/flatnotes/image.png b/blueprints/flatnotes/image.png
new file mode 100644
index 0000000000000000000000000000000000000000..3796c5868bd5055322ec054f9a2b7c2d6812b444
GIT binary patch
literal 4974
zcmV-!6OrtRP)<h;3K|Lk000e1NJLTq006}R001lq1^@s6)pLBh000mGNkl<ZcmeEO
z4V+Wel|SdbWS9|DaH;rF)T+2E3Ki=X`JM!n`T<OWVin8RB!h|{``d2U<)>TFU9Gy^
z->;&GOfuk7^jAkrhEHp)d4nKTSJx`FY>QO1)gqQ6NMUA@_iq39CHGAdl1v7MnMjl0
zJMWx(?!D)pd)__wdq$)3uWW&`1u`s9c8Uyhlmlf85S5*x+zQGT$g)7$DY6Vw4wfxo
zJ4MUNdDk9#dfw)ir|0c$d1jvIRzR6{+0dc<Im#9&1q*1c&)iyrNz__q8bwTfsk?tD
z(=J=1wYDyH`Q=yH0zGE|%@TZf&lR6paw+MOsaZMnw`2hgz4V2pQsJ)Dr6JmURXEx_
zKNK<U2}fV~W~tP%tViiv0BZ_9xpdS#dR@Xz#@*p)Y@Z;pfk-?ENBd7A^Yu_9HbvF*
ziFKR$g`!5ag!-s)iQ<=W*#go6a0-cz9Ju%25uY^R$OUv!&J{1d*gG7FZ6rYt5j3Lo
zpP&|3KYmfMDieusFp*({5I<7<GA>&{THwf?La!kAm^yNgoJFpSCX#FTbSbaLp!JaZ
zE@B?*C?IGX=*I=oeZ=&=*&a^|!bkUXL2fxZNvLnyII;`Gm6V9^^Dmz*>t@56jbAG%
z<vO9v5j%x@<V+I#cTw9*|4s2<tRVB(FLk2WW02J1NlGfFPK^P-XK=vhxg+TFEChaB
z#q}f(J#T!~9-ZVUCCo@q>T)c~7Meao)sGTp;8>K=9Wsx|DYUaLB|f1qCEi)%=qSF}
z?a)0!usB1ND_DP2(Pdn=KxZv*1Wv)^9##W~Sl8LIj&=H8ssNq!or*5wvIRP8flfPx
zcIL$-Op~l#a?0M>;*Mc@ft5o_yi04vD4q)BK&FK~sT}+=>*y@N!gA~m3p@1DN$vjJ
zopuU+&=@jzyxRSmW|g?K@uico&DyMhnNL+o;tB0J#h17tYRpn`66=}}5*G{M#x18{
zt9NcVV#LBxL$pKey->th*?=>Ve6kid8ht{Mn5`$=_BoY~i3cdY!m=C{FL5Z+e1(b&
zMVoJxJPDzu*wxTwT{sfkDRlvS09X}Xy|I0xK_)B$macvC1e9?n@^1lr1Q1v#e+GCr
z6fu@8Tea!jLSjNq#tk8-emq;Hg@LClzKxq=kEpnOSZ<G_{562>;b`nYIAZJ$M-3ws
zjV)@37^Cy$%g3*8YW9Vru?Cd?PB?1p2Z&I_I2ei=FEvD8zA|6F&N)R@U(!w=Oy-Ag
z<&)Qa{3@55na3%}DtLtAOKcIHLr3_N&Oq+gJtXK!G-^+#7#_?_)3LDM5RS&4mX4Yk
zPjrHtT<qvcm#4?K^ON<^d$(4k#}kVIDh<wD&Xe2D_^8jZ;Pueu8e%>>m0s3wDp}UX
zP&D?8bi@?DAZm!lrfP{V{(v&%8f*j-4+Ibs^#=@LrdupMu>)o1-Kb!T26C!?$Sd^#
zBFNyg6klQzJd_IjV818O7~e(`xnXiX5%-3WuMkl+6W<}2Hlc3MuH5k2Nz}nFygD{2
z95uG1@55#W&q4XJ>=R`+W~ySM34*j2(b4?7<Yfc&$Y$ja>jN(#dqI70Z~jEbQA|VB
zSU}PlDC74zoZv0+v*wR{lkU>jWTZskklTfC0HTPetwqn9mPv5iLH8nj)az_fID3Jk
zyiS5PW86Dr^YCKg8!KG25@f*#qtN#R@hT?jrxFSwc0<-{B*gC&PhylgFC2+&lujwb
zT?tFq8vVo3*y}{>jD&=rAo?YA`G1hk!^G2CS`NJ_^Ek{bqCT?e0%6j6u;EyEw?A*A
ze)1e^mtw)D_ru};O@$Tilv8M@o=4X1_f_5=#d9Zl{)DYoR)B{3sZt0>D5opF#By6!
z#TAPi(2L^3EL7?7fnFm`jE1~^L7(@s)Rr$3iT1l=%wxk5<J&5a#J62LW^cgfvGo+_
zRV7b?An~c<D?E4V*gwj++`t&6cn;!r;$vQi@~Z+q@8!T_;uWqlA+Hf}_QOn5!cEPx
z$F;-RuVqcK;mo3aIwNSkrHhM$e(!*w-!mfM_nv3Q6MZ4`Kb*X%TkFA!`<!r!2>3le
zRQiL}-t!82K=CCG`aIu4{9%ul5UYtebqz=Cu>{?kN<S><_gvT-rxRIl9T9y2AYvM%
z$3+w6`7y=onc2Rj0sVI{@zqiu;L@PqTOIIwPKVRqud*}K55ig3fI8(A+;1Ssvk4{e
zc*a8TLRCLOv<@F=L|}^du*Fos=Y0gd^}}gtrzyIN@i3IL4UP4ZTA%m%blKAJf<EsJ
z;H?EDAIr*nPGAXMl1zlRpr4?jTw6EU`yN8hGk4k*`yliCg6Vq2WTNjjtd9M?3Lh;F
zMU8)AV*3zNkl3LUUsmV$Jee+c-ZamFT7PwjHS#)q=27(#<60-2B349RJ(ZcqrGliJ
z?kj73)i0>9!U4Z`0m{8og@s7WQ?$gzI|a1jKK)62@tMqb+yffQ5KGV`I7CBLud0H_
z^%l97wHrjFdcAf|mr<<Gl8rT=Je{?BoH*vm4xL7Xuy{vs7yyGD?K&yZYmQClc?D}c
ztI)HCRJ1VpUliQ|?l78#XdhXKZkX-!<lRcIo#J^DdMr>vndvS?E8NEBIf}+q>D@Wk
zjmek>syK<^ERVqv=bB`lAM|@?N}htEoq~IxV&@TU&h*s|m*T6?+`KdTqSsm%^mzg|
zUw!%hLiy_aV}7gRnfXjbcPSRMJ>VPrMj@HAYsPIQ5{|C9=HAR!+VqYenKo@?haXha
zbY~ickz;B;9Rx9}I5aqiR=jj<J14W<sF1c1qf&>vHx<;&8ATv`LSy5Ws&tvA&dz!P
z{L=shACy@?*EfDgcA}!3LXHrwp~)#~#n>QKjK9kP_h^jLz4~O!?a^>Wr75~of$Z(V
zVt0Q!r6W^Oi#b%>X&72ule;$=#RzI2K}<Fe+Zf15oC?gT8TWgTZvqI7(Y|3U>1<$h
z<%-9|LeV)fTge86NHoHX=^$7+pBes9^4f&lp|a!m>8)S4iPUTE<S`#%g!otn8C&!r
z?8Jpu|Gd+;RiTd*aX4`QuaSP<C~|x6q>4!kNjv)+P9kw=zrEnLc5f$ZFYJ|Qb>fb9
zBDDIIq2WmL^>RB8I~S2Kc4aIU&JEmSRe!WFX9Or%hM>5LXR>rfOWd$}^NCE<U(y&+
z_T=g%lW~W?g`n3J7t@||6@BEGoeP5&@s**dv9K7xsM6ahQy2C~<Ag!5#?Gk5#5b~~
z?+Qna4dJHPZ5TQK0ZBT1aytcje%FwziTj*F=5Gv&zx*hPeV>r{%N}ZNx|iZxmQ!Nu
zdcX!U-$Q#ao$t_Lf!&dytENv<SGfxnju;_0z#A~GV9R_5onRxAxSyGP#5|UXPmpO9
zRQ7VSqI(kSnwF(Un{z)5dO5pwpgVq;{-hEK)^bh}1&raOA(2(Kib-NbIx;}l0u~ep
zd_htIk!G>8ove6)8qZRU7BLl0;j5s|Vm(3I@Etz^JO>A?O~oCCayv!q0g4-oDe=x)
zvOeC5QDHk#yoJQ)*fA_I2RN)oV06XwY598Nv~VQ086SETF$I|EA0gU#1kndD{zmj%
z8_<j1OM;xM=`F2sL_0})j4&;16{MAJTAVfq=S~gpsK2xJz(~>FTc^oKN8!|)sqpj(
zHcQhbO-Lt5lgK`h%g%y@^LRmgn;=4uof*qar=u>{F;N)bcjvN5%-O9{DRVo8icQ0E
zT_Fy9mc}{0NwZbJ8F-XaOF`QNi~q8i{Q;aiU;%zEj9(q}d9MljJrAG_;2SxqOOkL`
zkh9)^f~jc~sA3)=+NUZ^=pBp6ls^p`rlX5UHein+>J;d@JMWq(=&N25#My|@%+ufi
zv(afS1^g;QBj&SB;uqxgl5~D?PJtRw<%!tW=-h~#UeK3`Zjkq4IL#rLf&ss0aInVv
zuXQ!m(Jxb7(siAEjmK$-;187do`8#c1UqX068uSVnewN?2<teOrdc1O0XKIRYNw3u
zP><l037^*bJWt{K-2xb5AE4r35#=A0+A&j=M#9<ElDwjv!Zl3p!ZBG`SIA7I4s8Xl
zOBAEKARe#M!FZ1aYCK^T&V`p7MkNtDQ;O1EQxJZleZg$*9|J~F4^{{hR6^6GJ2Dhc
zV%QCxvZSz#hvy`z+;0~Ae=5eZ$dRph#|j6hdj0_CxL2@#MSB@MJbjm{D5ua)ztGNa
zuPJP*v|nAYrf{Yf%$#x3o2%xDy_S6{tKy1UQ=kQ@^v4QkuPN+ug!ZhB@zN}+1M2Vz
zH5qaat`@bwkXxU*GBIJL;6!l2wuJ-F^r_FZV((QgjlO)IQ$!A;VfE%S8luLm>@$q)
zq;)mpwqQ-TTk&<Foug<?5qUA{CjT*kIDpNExU<%3PmXDocIqIq;jBwZzxXPWJ6E|t
z{>5H<#uBCkJ3~8JqQh$qaGVE=sZ9l&jscP9)Q&z}F)}-w#uVC5NNoyWebmu)b9pP3
z1^qykgOT$oMQ39{<kSyi#TnW0>EYyor}&NJG4X)bgYJ-|3xS;b>!iIOju^YKgS0X`
zE%=SXihm3}mhX497QAj_*9&JEN`}dnbDFLxW?ro6M3zb7v)m`<`oLlBPB3T;=>smX
z9fbR1E8B%xMVerCCpR3@SS3kXM6W5u1oN!=$R=kSQ1K-W%fGXT#N>sx;WFG2%=Ay#
zLs*%qbo*T`huzRramNbFONWAKzLGCYb4~s8%^5puDsFky=zFN;pzP7lw|Rm#V`HJ-
zrgOXmv(reJX=?qN*hM*#IV_F&b`^kQ+!%_)9#!FNj0QgwyI##UpXn<Yl@4o6C?6;K
zb_&9#$ivH5Z5)&gWxnMdsY9)YoC8BR`WCtNP^mh03T(lezip<(_E%J%3~YkmhI5Q;
zh#QYn;_ZlimXX-H!N#TV$4ME==LyK`9heB%*Or;6pN7rpP}KNweZ;s0ALm=)CSxu>
z;Qx@j<s)LAj9J4gq<Y^xG8J18x8IXu{(dMLdlj;p!%;&vK9%g4Vk~HX1n2yjEQFa)
z)->@3>eU#EHs4y`6q^{1Hh(7+HGY^7VkhF0Tb4rnS+iUjcZ6jAbm-ew@zeGx3HN4`
zH_5t5kTy$CE9p5ko}a_cizO`qWywEw+74YFvUP~Wri7!h2NB*%Oiv*`dHYq+A7S%<
zrmUY8k1s+4|46bKqmQXs?;`&S`Q2o_LXqa#p=fMT8?}ANl(vpxEu(Yl*eOs#;_WDj
zJ<jL?PH8_!yU<S7PV?h~9k6MpN*M8GjcEx!&I=^yNqnFgWG}A89-Vn6dL|4oWd8~+
zw5xhmEf7Ro?SyzS@kq#$4R6xYHJi=?tIHl;gT{HJofNOEK?9CC(M;E)_kBVW{8Kp0
z3MTq4^hz~Cv0IQny3hqXDM#L;(lvH2PeMjN$QUO9woLvVaqC%|0009QNkl<Zh)kFU
z*v`HkdZbT3&xeigwsl}`BI5Z7Urg#J=vOSP5rL`WKU6G*<z-3TbbIi9aIgk0z8evL
z2Ub`j>%}aVG4UOcS4qx~X9R1iH#tENML7l1eW{)<SZGtwKW>|DxxS8%^Gx2#3o<O>
z9w~2kG7_qEg%;ZKa-kJZj3FUHD!sxkGoJC6d5V9e*vvY-OP3=Xu&W<mgT^`^jdFK-
zTsn=o739({m-a~K=cDJK_qQzmCLI5l8EFLNty|FVy@$z~h{kMW<jD-YkKi2vzh_7;
zhd`YDNXOOt(NNUucF0RQhaHpk5@hJC4Gs9Je@t1w<Hjk1KJRG(9I8pk+K<nwGLign
zGM$8=-&=iHf)qm<IN<Y6uQ;KtkNjv%d?!BkeK7dF@{e)?evdb~U?f7iK2n~9dDA?}
z5hf)k8_6Cm;P=+agC)qb53Gpv;k7=m^M^t*PtfOCDdkB3op!rb#^#2g-+Qr4Z-d{H
zd03T|WwyuD67+i>3i`bRWc{E^03+T#sNd}t7U6D}^;N{p3{D>RK~~m+!Mdr{{|kMG
zVJdSOWZL!9HEnRAOtrr8KMTN~8tWG^i5uXIcR`Q&g6Z2rXoFFoL4d~#$xv~rdM$>$
z3xuwn%bJ)XWwGEojp+*3+$SN<JG*9_Gh(Z}62mFPK1q}Y^r$X*O)z8P#J|XoR_m*N
z3?F+T8qx#Vf0UCqbAbrCxPv_V&??|7d@a0ym@bKu^@A=A!5Z&_sNZ6FNI7%Tc>Bib
zkroj2dEbIeyMA+O#{Iq+Idf{p{<;>OL(uPC1U()K)_9&Rc9hB`UpjQ{6z>`-tJYr~
znuC!HhknVw;>(o*JPjVS4Y(wpQqrX)3{qC2M=YReEFSKWl5-SVO1k7wugv-zv4Ga=
zrX@{e(IoWJuVP{HdAHYF(C2p9(81QF+Z8AmShhf>1+b<ds=Rsex~l1mM^{c?+^_Pc
z#oVocGVQXVL#ArwP}u@KV*%SKdZy@dsl{2KoT|GmP<D#$ws^U`lD9zFDN6nml@;u6
s3;Y!T0RR7Bg?UT>000I_L_t&o0K@w5!V4dsp#T5?07*qoM6N<$f(Emm{r~^~

literal 0
HcmV?d00001

diff --git a/blueprints/flatnotes/template.toml b/blueprints/flatnotes/template.toml
new file mode 100644
index 00000000..6749da36
--- /dev/null
+++ b/blueprints/flatnotes/template.toml
@@ -0,0 +1,32 @@
+[variables]
+main_domain = "${domain}"
+username = "${username}"
+password = "${password:16}"
+secret_key = "${password:32}"
+
+[config]
+[[config.domains]]
+serviceName = "flatnotes"
+port = 8080
+host = "${main_domain}"
+path = "/"
+
+[config.env]
+PUID = "1000"
+PGID = "1000"
+FLATNOTES_AUTH_TYPE = "password"
+FLATNOTES_USERNAME = "${username}"
+FLATNOTES_PASSWORD = "${password}"
+FLATNOTES_SECRET_KEY = "${secret_key}"
+FLATNOTES_SESSION_EXPIRY_DAYS = "30"
+FLATNOTES_TOTP_KEY = ""
+FLATNOTES_PATH_PREFIX = ""
+FLATNOTES_QUICK_ACCESS_HIDE = "false"
+FLATNOTES_QUICK_ACCESS_TITLE = "RECENTLY MODIFIED"
+FLATNOTES_QUICK_ACCESS_TERM = "*"
+FLATNOTES_QUICK_ACCESS_SORT = "lastModified"
+FLATNOTES_QUICK_ACCESS_LIMIT = "4"
+
+[[config.mounts]]
+name = "flatnotes-data"
+mountPath = "/data"
diff --git a/meta.json b/meta.json
index 014bddd2..f426816a 100644
--- a/meta.json
+++ b/meta.json
@@ -2003,6 +2003,44 @@
       "ddos-guard"
     ]
   },
+  {
+    "id": "flatnotes",
+    "name": "Flatnotes",
+    "version": "latest",
+    "description": "A self-hosted, modern note-taking web app that saves your notes as plain text Markdown files.",
+    "logo": "image.png",
+    "links": {
+      "github": "https://github.com/dullage/flatnotes",
+      "website": "https://flatnotes.io",
+      "docs": "https://github.com/dullage/flatnotes"
+    },
+    "tags": [
+      "notes",
+      "productivity",
+      "markdown",
+      "self-hosted"
+    ]
+  },
+  {
+    "id": "flatnotes-totp",
+    "name": "Flatnotes (TOTP)",
+    "version": "latest",
+    "description": "Flatnotes with TOTP authentication enabled (username + password + one-time passcode).",
+    "logo": "image.png",
+    "links": {
+      "github": "https://github.com/dullage/flatnotes",
+      "website": "https://flatnotes.io",
+      "docs": "https://github.com/dullage/flatnotes"
+    },
+    "tags": [
+      "notes",
+      "productivity",
+      "markdown",
+      "self-hosted",
+      "totp",
+      "2fa"
+    ]
+  },
   {
     "id": "flowise",
     "name": "Flowise",