Fan New Tab is a modern, feature-rich browser extension that transforms your new tab experience. Built with Vue 3 and TypeScript, it offers a beautiful interface with powerful customization options, multiple search engines, bookmark management, and various display modes to enhance your browsing productivity.
- 🔍 Smart Search: Multi-engine search with customizable search providers
- 📚 Bookmark Management: Organize and access your favorite sites with custom categories
- 🎨 Theme Customization: Light/dark mode with custom colors and backgrounds
- 📱 Multiple Display Modes: Standard, Favorites, and Minimal modes
- ⚡ Fast & Lightweight: Built with modern web technologies for optimal performance
- 🔧 Highly Customizable: Extensive settings for personalizing your experience
Clean interface with search bar and organized site grid
Comprehensive customization options
- 🥝 Vue 3 - Progressive JavaScript framework
- 🦾 TypeScript - Type-safe JavaScript
- 🧱 Vite - Fast build tool and dev server
- 🎨 TailwindCSS - Utility-first CSS framework
- 🔍 Iconify - Comprehensive icon library
- 📦 Dexie.js - IndexedDB wrapper for data storage
- Multi-Engine Support: Google, Bing, Baidu, Yandex, and more
- Custom Search Engines: Add your own search providers
- Customizable Search Bar: Adjust size, style, opacity, and border radius
- Keyboard Shortcuts: Quick search with
Ctrl+Shift+K(orCmd+Shift+Kon Mac)
- Organized Collections: Create custom categories for your bookmarks
- Browser Sync: Import bookmarks directly from your browser
- Drag & Drop: Reorder bookmarks and categories easily
- Quick Access: One-click access to your favorite sites
- Light/Dark Mode: Toggle between themes or auto-detect system preference
- Custom Backgrounds: Upload images or use solid colors
- Background Effects: Blur and opacity controls
- Color Themes: Customize primary colors and accents
- Responsive Design: Adapts to different screen sizes
- Standard Mode: Search bar with organized site grid
- Favorites Mode: Focus on bookmark collections with tabs
- Minimal Mode: Clean interface with search bar only
Before installing, make sure you have:
- Node.js (version 16 or higher)
- npm or yarn or pnpm package manager
- A modern browser (Chrome, Firefox, Edge, etc.)
-
Clone the repository
git clone https://github.com/fzzv/fan-new-tab.git cd fan-new-tab -
Install dependencies
npm install
-
Start development server
npm run dev
-
Load extension in browser
- Open your browser's extension management page
- Enable "Developer mode"
- Click "Load unpacked extension"
- Select the
extensionfolder
-
Build the extension
npm run build
-
Package the extension
npm run pack
This will create extension.zip, extension.crx, and extension.xpi files for different browsers.
Chrome/Edge:
- Go to
chrome://extensions/oredge://extensions/ - Enable Developer mode
- Click "Load unpacked" and select the
extensionfolder - Or drag the zip file into the extension management interface
Firefox:
- Go to
about:debugging#/runtime/this-firefox - Click "Load Temporary Add-on"
- Select the
manifest.jsonfile in theextensionfolder
| Browser | Version | Status |
|---|---|---|
| Chrome | 88+ | ✅ Fully Supported |
| Firefox | 89+ | ✅ Fully Supported |
| Edge | 88+ | ✅ Fully Supported |
| Safari | 14+ | 🚧 Experimental |
- First Launch: After installation, open a new tab to see Fan New Tab
- Settings: Click the settings icon (⚙️) in the top-right corner
- Theme Toggle: Use the sun/moon icon to switch between light and dark modes
- Manual Addition: Click the "+" button to add a new bookmark
- Browser Import: Go to Settings → Import → Sync from Browser
- Drag & Drop: Organize bookmarks by dragging them between categories
- Search Engines: Settings → Search → Add/Remove search engines
- Backgrounds: Settings → Theme → Upload custom background images
- Display Mode: Settings → Display → Choose between Standard, Favorites, or Minimal
- Colors: Settings → Theme → Customize primary colors and accents
Ctrl+Shift+K(orCmd+Shift+K): Open command paletteTab: Navigate between search enginesEnter: Perform searchEsc: Close modals and popups
fan-new-tab/
├── src/
│ ├── newtab/ # New tab page components
│ ├── popup/ # Extension popup
│ ├── background/ # Background scripts
│ ├── content/ # Content scripts
│ ├── components/ # Reusable UI components
│ ├── composables/ # Vue composables
│ └── types/ # TypeScript type definitions
├── extension/ # Built extension files
├── scripts/ # Build scripts
└── package.json
| Command | Description |
|---|---|
npm run dev |
Start development server with hot reload |
npm run build |
Build for production |
npm run pack |
Package extension for distribution |
npm run lint |
Run ESLint |
npm run typecheck |
Run TypeScript type checking |
- Make changes to source files in
src/ - The development server will automatically rebuild
- Reload the extension in your browser to see changes
- Use browser developer tools for debugging
We welcome contributions! Here's how you can help:
- Use the GitHub Issues page
- Provide detailed information about the bug or feature request
- Include screenshots if applicable
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes and test thoroughly
- Commit with descriptive messages:
git commit -m 'Add amazing feature' - Push to your branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow the existing code style
- Add TypeScript types for new features
- Test your changes across different browsers
- Update documentation as needed
Extension not loading:
- Ensure you've selected the correct
extensionfolder - Check that Developer mode is enabled
- Try refreshing the extensions page
Search not working:
- Check your internet connection
- Verify search engine URLs in settings
- Clear browser cache and reload
Bookmarks not syncing:
- Grant necessary permissions when prompted
- Check browser bookmark permissions
- Try manual import/export
Performance issues:
- Reduce background image size
- Disable unnecessary animations in settings
- Clear extension storage data
- Check the FAQ
- Search existing issues
- Create a new issue with details
This project is licensed under the MIT License - see the LICENSE file for details.
- Vue.js - The progressive JavaScript framework
- Vite - Next generation frontend tooling
- TailwindCSS - Utility-first CSS framework
- Iconify - Universal icon framework
- Dexie.js - Minimalistic IndexedDB wrapper
- ✅ Core functionality complete
- ✅ Multi-browser support
- 🚧 Chrome Web Store submission pending
- 🚧 Firefox Add-ons submission pending
- 📋 Roadmap available in Issues
Fan New Tab 是一个现代化的浏览器新标签页扩展,使用 Vue 3 和 TypeScript 构建。它提供了美观的界面和强大的自定义选项,包括多搜索引擎支持、书签管理和多种显示模式,旨在提升您的浏览体验。
- 🔍 智能搜索: 支持多搜索引擎,可自定义搜索提供商
- 📚 书签管理: 组织和访问您的收藏网站,支持自定义分类
- 🎨 主题定制: 明暗模式切换,自定义颜色和背景
- 📱 多种显示模式: 标准模式、收藏模式和极简模式
- ⚡ 快速轻量: 使用现代网络技术构建,性能优化
- 🔧 高度可定制: 丰富的设置选项,个性化您的体验
- 多引擎支持: Google、百度、必应、Yandex 等
- 自定义搜索引擎: 添加您自己的搜索提供商
- 可定制搜索栏: 调整大小、样式、透明度和圆角
- 键盘快捷键: 使用
Ctrl+Shift+K快速搜索
- 分类收藏: 为书签创建自定义分类
- 浏览器同步: 直接从浏览器导入书签
- 拖拽排序: 轻松重新排列书签和分类
- 快速访问: 一键访问您的收藏网站
- 明暗模式: 手动切换或自动检测系统偏好
- 自定义背景: 上传图片或使用纯色背景
- 背景效果: 模糊和透明度控制
- 颜色主题: 自定义主色调和强调色
- 响应式设计: 适配不同屏幕尺寸
- 标准模式: 搜索栏配合网站网格布局
- 收藏模式: 专注于书签收藏,带标签页
- 极简模式: 仅显示搜索栏的简洁界面
安装前请确保您有:
- Node.js (版本 16 或更高)
- npm 或 yarn 或 pnpm 包管理器
- 现代浏览器 (Chrome、Firefox、Edge 等)
-
克隆仓库
git clone https://github.com/fzzv/fan-new-tab.git cd fan-new-tab -
安装依赖
npm install
-
启动开发服务器
npm run dev
-
在浏览器中加载扩展
- 打开浏览器的扩展管理页面
- 启用"开发者模式"
- 点击"加载已解压的扩展程序"
- 选择
extension文件夹
-
构建扩展
npm run build
-
打包扩展
npm run pack
这将创建适用于不同浏览器的 extension.zip、extension.crx 和 extension.xpi 文件。
Chrome/Edge:
- 访问
chrome://extensions/或edge://extensions/ - 启用开发者模式
- 点击"加载已解压的扩展程序",选择
extension文件夹 - 或者直接将打包后 zip 格式的文件拖进扩展管理界面
Firefox:
- 访问
about:debugging#/runtime/this-firefox - 点击"加载临时附加组件"
- 选择
extension文件夹中的manifest.json文件
| 浏览器 | 版本 | 状态 |
|---|---|---|
| Chrome | 88+ | ✅ 完全支持 |
| Firefox | 89+ | ✅ 完全支持 |
| Edge | 88+ | ✅ 完全支持 |
| Safari | 14+ | 🚧 实验性支持 |
- 首次启动: 安装后,打开新标签页即可看到 Fan New Tab
- 设置: 点击右上角的设置图标 (⚙️)
- 主题切换: 使用太阳/月亮图标切换明暗模式
- 手动添加: 点击"+"按钮添加新书签
- 浏览器导入: 设置 → 导入 → 从浏览器同步
- 拖拽整理: 通过拖拽在分类间移动书签
- 搜索引擎: 设置 → 搜索 → 添加/删除搜索引擎
- 背景图片: 设置 → 主题 → 上传自定义背景图片
- 显示模式: 设置 → 显示 → 选择标准、收藏或极简模式
- 颜色主题: 设置 → 主题 → 自定义主色调和强调色
Ctrl+Shift+K(或Cmd+Shift+K): 打开命令面板Tab: 在搜索引擎间切换Enter: 执行搜索Esc: 关闭模态框和弹窗
fan-new-tab/
├── src/
│ ├── newtab/ # 新标签页组件
│ ├── popup/ # 扩展弹窗
│ ├── background/ # 后台脚本
│ ├── content/ # 内容脚本
│ ├── components/ # 可复用UI组件
│ ├── composables/ # Vue组合式函数
│ └── types/ # TypeScript类型定义
├── extension/ # 构建后的扩展文件
├── scripts/ # 构建脚本
└── package.json
| 命令 | 描述 |
|---|---|
npm run dev |
启动开发服务器,支持热重载 |
npm run build |
生产环境构建 |
npm run pack |
打包扩展用于分发 |
npm run lint |
运行 ESLint |
npm run typecheck |
运行 TypeScript 类型检查 |
欢迎贡献!以下是参与方式:
- 使用 GitHub Issues 页面
- 提供详细的错误信息或功能请求
- 如适用,请包含截图
- Fork 仓库
- 创建功能分支:
git checkout -b feature/amazing-feature - 进行更改并充分测试
- 提交时使用描述性消息:
git commit -m 'Add amazing feature' - 推送到您的分支:
git push origin feature/amazing-feature - 打开 Pull Request
- 遵循现有代码风格
- 为新功能添加 TypeScript 类型
- 在不同浏览器中测试您的更改
- 根据需要更新文档
扩展无法加载:
- 确保选择了正确的
extension文件夹 - 检查是否启用了开发者模式
- 尝试刷新扩展页面
搜索功能不工作:
- 检查网络连接
- 验证设置中的搜索引擎URL
- 清除浏览器缓存并重新加载
书签同步失败:
- 在提示时授予必要权限
- 检查浏览器书签权限
- 尝试手动导入/导出
性能问题:
- 减小背景图片大小
- 在设置中禁用不必要的动画
- 清除扩展存储数据
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
- Vue.js - 渐进式 JavaScript 框架
- Vite - 下一代前端构建工具
- TailwindCSS - 实用优先的 CSS 框架
- Iconify - 通用图标框架
- Dexie.js - 简约的 IndexedDB 包装器