Mimir — 2FA Authenticator

🇬🇧 English

Introduction

Mimir is a modern, secure, and responsive Two-Factor Authentication (2FA) manager built with React Native (Expo Router + Tamagui), Zustand, TanStack Query, and Cloudflare Workers + D1. It supports web, Android, and iOS platforms.

✨ Features

🔐 RFC 6238 TOTP Engine — Pure TypeScript TOTP (SHA-1/SHA-256), Base32 decoding, live 30s countdown ring, otpauth:// URI parsing
🛡️ Secure Local Vault — Master password verification, biometric unlock simulation, inactivity auto-lock
📂 Custom Categories & Providers — Create, edit, delete categories and providers with custom icons and color tags
🌐 Responsive UI — Adaptive layout for mobile (bottom nav, FAB) and desktop (sidebar, multi-column grid)
🎨 Themes — Light/Dark/System, 6 color schemes (Secure Blue, Cyber Purple, Emerald Green, Crimson Red, Sunset Amber, Midnight Titanium)
🌍 Internationalization — Chinese (简体中文) / English instant switching
☁️ Cloudflare Workers & D1 — Edge API powered by Hono with D1 database for cross-device sync
🔑 Multi-Account Isolation — Each user account has fully isolated data with registration and login support
📋 Recovery Codes — One-click copy of provider backup recovery codes

🚀 Deploy to Cloudflare

Steps:

Click the button above to fork and deploy this project to Cloudflare Workers
Set up a Cloudflare D1 database and update wrangler.toml with your database ID
Run database migrations: wrangler d1 execute <DB_NAME> --file=./schema.sql

🐳 Docker Deployment

Quick Start

# Clone the repository
git clone https://github.com/NornsInteractive/2fa-auth.git
cd 2fa-auth

# Build Docker image
docker build -t mimir-2fa .

# Run the container
docker run -d -p 8080:8080 --name mimir-2fa mimir-2fa

Docker Compose

version: '3.8'
services:
  mimir:
    build: .
    ports:
      - "8080:8080"
    environment:
      - NODE_ENV=production
    restart: unless-stopped

docker compose up -d

Visit http://localhost:8080 after starting the container.

📦 Getting Started (Local Development)

# Install dependencies
npm install

# Start web dev server
npm run dev

# Build web static bundle
npm run build:web

Cloudflare Workers & D1

# Initialize local D1 database
npm run d1:init

# Start local worker dev server
npm run worker:dev

# Deploy to Cloudflare Workers
npm run worker:deploy

📱 Build Android APK

Prerequisites

Node.js 18+
JDK 17
Android SDK (via Android Studio or command-line tools)
Set ANDROID_HOME environment variable

Build Steps

# Generate native Android project
npx expo prebuild --platform android

# Build debug APK
cd android && ./gradlew assembleDebug
# Output: android/app/build/outputs/apk/debug/app-debug.apk

# Build release APK
cd android && ./gradlew assembleRelease
# Output: android/app/build/outputs/apk/release/app-release.apk

Using EAS Build (Cloud)

# Install EAS CLI
npm install -g eas-cli

# Login to Expo account
eas login

# Configure build
eas build:configure

# Build APK (requires Expo account)
eas build -p android --profile preview

🍎 Build iOS

Prerequisites

macOS with Xcode 15+
Apple Developer Account
CocoaPods installed (gem install cocoapods)

Build Steps

# Generate native iOS project
npx expo prebuild --platform ios

# Install CocoaPods dependencies
cd ios && pod install && cd ..

# Open in Xcode and build
open ios/mimir-2fa-auth.xcworkspace

In Xcode:

Select your development team in Signing & Capabilities
Select a connected device or simulator
Press Cmd + R to build and run
To archive for distribution: Product → Archive

Using EAS Build (Cloud)

eas build -p ios --profile production

🛠 Tech Stack

Layer	Technology
Framework	Expo + React Native Web
Routing	Expo Router
UI	Tamagui
State	Zustand
Data Fetching	TanStack Query
Backend	Hono on Cloudflare Workers
Database	Cloudflare D1

📄 License

This project is licensed under the Apache License 2.0.

🇨🇳 中文

简介

Mimir 是一款现代化、安全且响应式的双因素认证 (2FA) 管理器，基于 React Native (Expo Router + Tamagui)、Zustand、TanStack Query 和 Cloudflare Workers + D1 构建。支持 Web、Android 和 iOS 多平台。

✨ 功能特性

🔐 RFC 6238 TOTP 引擎 — 纯 TypeScript 实现 TOTP (SHA-1/SHA-256)，Base32 解码，实时 30 秒倒计时环，otpauth:// URI 解析
🛡️ 安全本地保险库 — 主密码验证、生物识别解锁模拟、不活动自动锁定
📂 自定义分类与提供商 — 创建、编辑、删除分类和提供商，支持自定义图标和颜色标签
🌐 响应式界面 — 自适应布局，移动端（底部导航、FAB）和桌面端（侧边栏、多列网格）
🎨 主题定制 — 浅色/深色/跟随系统，6 种配色方案（安全蓝、赛博紫、翡翠绿、绯红、日落琥珀、午夜钛）
🌍 国际化 — 中文（简体中文）/ 英文即时切换
☁️ Cloudflare Workers & D1 集成 — 基于 Hono 的边缘 API，D1 数据库支持跨设备同步
🔑 多账号数据隔离 — 每个用户账号数据完全隔离，支持注册和登录
📋 恢复码管理 — 一键复制提供商备份恢复码

🚀 一键部署到 Cloudflare

步骤：

点击上方按钮，Fork 并部署本项目到 Cloudflare Workers
设置 Cloudflare D1 数据库，并在 wrangler.toml 中更新数据库 ID
执行数据库迁移：wrangler d1 execute <DB_NAME> --file=./schema.sql

🐳 Docker 部署

快速开始

# 克隆仓库
git clone https://github.com/NornsInteractive/2fa-auth.git
cd 2fa-auth

# 构建 Docker 镜像
docker build -t mimir-2fa .

# 运行容器
docker run -d -p 8080:8080 --name mimir-2fa mimir-2fa

Docker Compose

version: '3.8'
services:
  mimir:
    build: .
    ports:
      - "8080:8080"
    environment:
      - NODE_ENV=production
    restart: unless-stopped

docker compose up -d

启动容器后访问 http://localhost:8080。

📦 快速开始（本地开发）

# 安装依赖
npm install

# 启动 Web 开发服务器
npm run dev

# 构建 Web 静态包
npm run build:web

Cloudflare Workers & D1 设置

# 初始化本地 D1 数据库
npm run d1:init

# 启动本地 Worker 开发服务器
npm run worker:dev

# 部署到 Cloudflare Workers
npm run worker:deploy

📱 打包 Android APK

前置条件

Node.js 18+
JDK 17
Android SDK（通过 Android Studio 或命令行工具）
设置 ANDROID_HOME 环境变量

构建步骤

# 生成原生 Android 项目
npx expo prebuild --platform android

# 构建 Debug APK
cd android && ./gradlew assembleDebug
# 输出路径: android/app/build/outputs/apk/debug/app-debug.apk

# 构建 Release APK
cd android && ./gradlew assembleRelease
# 输出路径: android/app/build/outputs/apk/release/app-release.apk

使用 EAS Build（云端构建）

# 安装 EAS CLI
npm install -g eas-cli

# 登录 Expo 账号
eas login

# 配置构建
eas build:configure

# 构建 APK（需要 Expo 账号）
eas build -p android --profile preview

🍎 打包 iOS

前置条件

macOS 系统，安装 Xcode 15+
Apple 开发者账号
安装 CocoaPods (gem install cocoapods)

构建步骤

# 生成原生 iOS 项目
npx expo prebuild --platform ios

# 安装 CocoaPods 依赖
cd ios && pod install && cd ..

# 在 Xcode 中打开并构建
open ios/mimir-2fa-auth.xcworkspace

在 Xcode 中：

在 Signing & Capabilities 中选择开发团队
选择已连接的设备或模拟器
按 Cmd + R 构建并运行
发布存档：Product → Archive

使用 EAS Build（云端构建）

eas build -p ios --profile production

🛠 技术栈

层级	技术
框架	Expo + React Native Web
路由	Expo Router
UI 组件	Tamagui
状态管理	Zustand
数据请求	TanStack Query
后端/边缘	Hono on Cloudflare Workers
数据库	Cloudflare D1

📄 开源协议

本项目基于 Apache License 2.0 开源。

Name		Name	Last commit message	Last commit date
Latest commit History 22 Commits
android		android
app		app
assets		assets
dist		dist
src		src
.dockerignore		.dockerignore
.gitignore		.gitignore
.mcp.json		.mcp.json
.npmrc		.npmrc
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
app.json		app.json
babel.config.js		babel.config.js
icon.png		icon.png
metro.config.js		metro.config.js
package-lock.json		package-lock.json
package.json		package.json
schema.sql		schema.sql
tamagui.config.ts		tamagui.config.ts
tsconfig.json		tsconfig.json
wrangler.toml		wrangler.toml

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Mimir — 2FA Authenticator

🇬🇧 English

Introduction

✨ Features

🚀 Deploy to Cloudflare

🐳 Docker Deployment

Quick Start

Docker Compose

📦 Getting Started (Local Development)

Cloudflare Workers & D1

📱 Build Android APK

Prerequisites

Build Steps

Using EAS Build (Cloud)

🍎 Build iOS

Prerequisites

Build Steps

Using EAS Build (Cloud)

🛠 Tech Stack

📄 License

🇨🇳 中文

简介

✨ 功能特性

🚀 一键部署到 Cloudflare

🐳 Docker 部署

快速开始

Docker Compose

📦 快速开始（本地开发）

Cloudflare Workers & D1 设置

📱 打包 Android APK

前置条件

构建步骤

使用 EAS Build（云端构建）

🍎 打包 iOS

前置条件

构建步骤

使用 EAS Build（云端构建）

🛠 技术栈

📄 开源协议

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages