CloudNav-MikuLab

简体中文 | 繁體中文 | 日本語

Copy for AI

Copy and paste this prompt to your LLM agent (Claude Code, AmpCode, Cursor, etc.):

Repository: https://github.com/MikuLab39/CloudNav-MikuLab

Read this README and write a detailed step-by-step tutorial for the project. Cover overview, deployment on Cloudflare Pages/KV, configuration, usage, and common checks. Keep the guide practical, accurate, and based on the real settings in this repository.

CloudNav-MikuLab is a personal navigation dashboard for fast access, cloud sync, and AI-assisted bookmark management.

Upstream sources

This project is based on and adapted from:

• https://github.com/sese972010/CloudNav-
• https://github.com/aabacada/CloudNav-abcd
• https://github.com/Aaowu/CloudNav-Oorz

The local fork is named CloudNav-MikuLab, and the demo site is https://nav.mikulab.com.

Features

• AI-assisted descriptions and categorization
• Cloudflare KV sync for bookmarks and settings
• WebDAV backup and restore support
• Password-based access controls
• Chrome extension support
• Browser bookmark import and export

Some ideas and implementation inspiration come from CloudNav-abcd.

Deployment

CloudNav-MikuLab is deployed on Cloudflare Pages with Cloudflare KV.

Steps

1. Fork the repository or connect it to Cloudflare Pages.
2. Create a Pages project and link it to the repository.
3. Set the build configuration:
   • Framework preset: None
   • Build command: npm run build
   • Output directory: dist
4. Create a Cloudflare KV namespace named CLOUDNAV_DB.
5. Bind the namespace to the Pages project as CLOUDNAV_KV.
6. Add the PASSWORD environment variable.
7. Redeploy the project after saving the bindings.

Notes

• CLOUDNAV_KV is the required Pages binding for app data.
• PASSWORD protects site/admin access.
• If you change the KV binding or environment variables, redeploy Pages again.

License

MIT.