Commit 09d2da88 authored by Vũ Hoàng Anh's avatar Vũ Hoàng Anh

docs: update README with extension-specific instructions and Canifa branding

parent 25b29d27
# CuCu Note Browser Extension # Canifa Note — Browser Extension
Browser extension để lưu note nhanh từ web - chỉ cần bôi đen text và save! ![Canifa Note Extension](public/canifa-extension.png)
## 🚀 Tính Năng Nổi Bật A modern, privacy-first browser extension designed for seamless, distraction-free note-taking directly from your active web pages. Built specifically for integration with the **Memos** backend infrastructure.
- **Bôi đen & Lưu Nhanh**: Tự động hiện popup khi bôi đen text trên web. ## ✨ Core Features
- **Tự Động Sync Auth**: Tự động lấy Clerk JWT session từ các tab OpenNotion đang mở.
- **Dual Write Sync**: Tự động lưu note song song về server chính và server tuỳ chỉnh (hiện tại: `http://172.16.2.210:5230/`).
## 🚀 Setup * **⚡ Lightning Fast Capture**: Highlight any text on a web page and press `Space` or `Enter` to instantly save it as a note. No context switching required.
* **🔗 Smart Source Tracking**: Automatically captures and appends the source URL and page title to your notes.
* **🔄 Zero-Click Authentication**: Seamlessly extracts and syncs your `memos.access-token` directly from active Canifa Note/Memos tabs. No secondary login required.
* **🎨 Premium UI/UX**: Fully redesigned using the **shadcn/ui** design system, featuring a sleek, dark-first interface with Canifa brand aesthetics.
* **🏷️ Intelligent Tagging**: Tag notes on the fly with a smart, autocomplete-enabled chip interface.
```bash ## 🛠️ Tech Stack
# Install dependencies
npm install
# Build extension * **Framework**: React 18
npm run build * **Build Tool**: Vite (optimized for Chrome Extension V3)
* **Language**: TypeScript
* **Styling**: Vanilla CSS (shadcn/ui token-driven architecture)
* **Backend Integration**: Native support for open-source Memos API
# Development mode (watch) ## 🚀 Installation & Setup
npm run dev
```
## 📦 Load vào Chrome ### Prerequisites
* Node.js 18+
* npm or pnpm
1. Build extension: `npm run build` ### Build Instructions
2. Mở Chrome: `chrome://extensions`
3. Bật "Developer mode"
4. Click "Load unpacked"
5. Chọn folder `extension/dist`
## 🎯 Cách dùng 1. **Clone the repository:**
```bash
git clone https://gitlab.hdtex.group/anhvh/canifa_note_extension.git
cd canifa_note_extension
```
1. **Bôi đen text** trên web 2. **Install dependencies:**
2. Extension hiện popup "💾 Save to CuCu Note" ```bash
3. Click popup → Form hiện npm install
4. Điền tag (ví dụ: "important, article") ```
5. Click "Save" → Done! Note sẽ được bắn đồng thời về 2 backend.
## 🏗️ Structure 3. **Build the extension:**
```bash
npm run build
```
*This will compile the TypeScript, bundle the React components, and output the final extension files into the `dist/` directory.*
``` ### Load into Chrome
1. Open Google Chrome and navigate to `chrome://extensions/`.
2. Enable **Developer mode** (toggle in the top right corner).
3. Click **Load unpacked**.
4. Select the `dist/` folder that was generated in the build step.
## 🎯 Usage Guide
1. **Log In to Backend**: Open your Canifa Note (Memos) instance at `http://172.16.2.210:5230/` and log in. The extension will automatically detect your session.
2. **Highlight & Save**: On any webpage, highlight a block of text.
3. **Shortcut**: Press `Space` or `Enter`. A success notification ("✓ Đã lưu vào Canifa Note") will appear, confirming your note has been saved to the server.
4. **Manual Entry**: Click the extension icon in your browser toolbar to open the quick-entry popup.
## 🏗️ Project Structure
```text
extension/ extension/
├── public/ # Static assets (icons, images)
├── src/ ├── src/
│ ├── content/ # Content script (detect text selection) │ ├── background/ # Service worker (Token management & API calls)
│ ├── popup/ # Popup UI (React) │ ├── components/ # React UI components (shadcn styled)
│ ├── components/ # React components │ ├── content/ # Content scripts (Text selection detection)
│ ├── background/ # Service worker (Dual write logic here) │ ├── popup/ # Popup UI entry point
│ └── shared/ # Shared code (API client) │ └── shared/ # Shared utilities & API client
├── manifest.json # Extension config ├── manifest.json # Chrome Extension V3 Manifest
└── vite.config.ts # Build config └── vite.config.ts # Vite build configuration
``` ```
## ⚙️ Config ## 🔒 Security
### Backend URL * The extension requests the minimum required permissions (`activeTab`, `storage`, `scripting`).
Sửa trong `src/shared/api-client.ts`: * Tokens are securely extracted locally and transmitted directly to your configured backend.
```typescript * No third-party analytics or tracking are included.
const DEFAULT_API_BASE_URL = 'http://160.191.50.138:3001'; // Thay đổi URL backend
const secondaryApiUrl = 'http://172.16.2.210:5230/api/v1/memos'; // Secondary Sync Backend ---
``` *Built for the Canifa AI Ecosystem.*
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment