WR.DO

Docs · Feedback · English | 简体中文

WR.DO is a all-in-one web utility platform featuring short links with analytics, temporary email service, subdomain management, open APIs for screenshots and metadata extraction, plus comprehensive admin dashboard.

• Official website: https://wr.do
• Demo: https://699399.xyz (Account: admin@admin.com, Password: 123456)

• 🔗 Short Link Service:

  • Custom short links
  • Generate custom QR codes
  • Password-protected links
  • Expiration time control
  • Access analytics (real-time logs, maps, and multi-dimensional data analysis)
  • API integration for link creation

• 📮 Email Service:

  • Create custom prefix emails
  • Filter unread email lists
  • Unlimited mailbox creation
  • Receive unlimited emails (powered by Cloudflare Email Worker)
  • Send emails (powered by Resend)
  • Support catch-all emails
  • Support push to telegram groups
  • API endpoints for mailbox creation
  • API endpoints for inbox retrieval

• 🌐 Subdomain Management Service:

  • Manage DNS records across multiple Cloudflare accounts and domains
  • Create various DNS record types (CNAME, A, TXT, etc.)
  • Support enabling application mode (user submission, admin approval)
  • Support email notification of administrator and user domain application status

• 📡 Open API Module:

  • Website metadata extraction API
  • Website screenshot capture API
  • Website QR code generation API
  • Convert websites to Markdown/Text format
  • Comprehensive API call logging and statistics
  • User API key generation for third-party integrations

• 🔒 Administrator Module:

  • Multi-dimensional dashboard with website analytics
  • Dynamic service configuration (toggle short links, email, subdomain management)
  • User management (permissions, quotas, account control)
  • Dynamically configure login methods (Google, GitHub, Magic Link, Credentials, LinuxDO)
  • Centralized short link administration
  • Centralized email management
  • Centralized subdomain administration

See step by step installation tutorial at Quick Start for Developer.

Remember to fill in the necessary environment variables.

Create a new folder and copy the docker-compose.yml、.env file to the folder.

- wrdo
  | - docker-compose.yml
  | - .env

Fill in the environment variables in the .env file, then:

docker compose up -d

git clone https://github.com/oiov/wr.do
cd wr.do
pnpm install

copy .env.example to .env and fill in the necessary environment variables.

pnpm postinstall
pnpm db:push

# run on localhost:3000
pnpm dev

• Default admin account：admin@admin.com
• Default admin password：123456

After v1.0.2, this setup guide is not needed anymore

Follow https://localhost:3000/setup

Via Installation For Developer.

• Next.js + React + TypeScript
• Tailwind CSS for styling and design
• Prisma ORM as the database toolkit
• Cloudflare as the primary cloud infrastructure
• Vercel as the recommended deployment platform
• Resend as the primary email service

This project is configured with a sync workflow for the upstream repository oiov/wr.do, featuring:

• 🔄 Manual Sync Trigger - Auto-sync disabled by default, full control over sync timing
• 💬 Auto Comment After Sync - Add detailed sync information to related commits
• 🚨 Smart Error Handling - Auto-create detailed Issues when sync fails
• 🧹 Auto Cleanup Notifications - Automatically close previous sync failure Issues

See How to Trigger Sync for details.

• Discord: https://discord.gg/AHPQYuZu3m
• 微信群：

MIT