Files
NebulaBrowser/documentation/FEATURES.md
T
andrew 95f5234613 Update documentation for new features and auth improvements
Expanded documentation to cover the new downloads manager, native context menu, OAuth/SSO and WebAuthn compatibility, and user agent strategy. Updated project structure and core concepts to reflect these features and clarified session and popup handling for authentication. Fixed minor typos and improved feature descriptions for clarity.
2025-09-08 18:39:35 +12:00

97 lines
4.7 KiB
Markdown

# Features
This document provides a detailed overview of the features available in Nebula.
### Privacy Control
Nebula is designed with your privacy in mind. You have granular control over your browsing data.
- **Clear Browsing Data:** You can easily clear your browsing history, cookies, cache, and local storage. This can be done from the settings page.
- **No Tracking by Default:** Nebula does not collect any personal data for tracking or advertising purposes.
### Tab Management
Efficiently manage your browsing session with Nebula's tab management features.
- **New Tabs:** Open new tabs to browse multiple websites at once.
- **Tab Controls:** Each tab has standard controls for closing.
- **Open in New Window:** You can pop a tab out into its own separate window.
### Bookmarks
Save and access your favorite websites with ease.
- **Add Bookmarks:** Save the current page to your bookmarks.
- **View Bookmarks:** Access your saved bookmarks from the bookmarks bar or a dedicated page.
### History
Nebula keeps a record of your browsing and search history to help you find your way back to previously visited sites.
- **Site History:** A list of all the websites you have visited.
- **Search History:** A list of all the searches you have made.
- **Clear History:** You can clear your history at any time from the settings page.
### Downloads Manager
Reliably download files with progress and controls.
- **Progress & State:** Each download shows received/total bytes and status.
- **Pause/Resume/Cancel:** Control active downloads where the server supports resuming.
- **Open or Reveal:** Open downloaded files directly or show them in your file manager.
- **Safe Filenames:** Files are saved to your OS Downloads folder with automatic de-duplication.
### Performance Monitoring
Nebula includes built-in tools to help you monitor the browser's performance.
- **Performance Report:** View a detailed report of performance metrics, including page load times and memory usage.
- **Force Garbage Collection:** Manually trigger garbage collection to free up memory.
### GPU Acceleration Control
For advanced users, Nebula provides tools to manage GPU acceleration.
- **GPU Diagnostics:** View detailed information about your system's GPU and its status.
- **GPU Fallback:** If you experience rendering issues, you can apply a GPU fallback to use a more stable rendering path. This can help resolve visual glitches or crashes.
### Native Context Menu
Nebula provides a native right-click menu across pages and webviews.
- **Navigation:** Back, Forward, Reload.
- **Links:** Open in new tab, Download link, Open externally, Copy address.
- **Images:** Open in new tab, Save image as, Copy image address.
- **Editing:** Undo/Redo, Cut/Copy/Paste, Select All when applicable.
- **Developer:** Inspect Element (opens DevTools docked by default).
### Authentication & Web Compatibility
- **OAuth/SSO Friendly:** Popup windows are allowed for http/https to support common login flows.
- **WebAuthn Diagnostics:** Platform authenticator features are enabled where supported and logged for troubleshooting.
- **Sturdy Navigation:** Login POST navigations are not intercepted by the main process.
### Custom Themes & Customization
Nebula offers extensive customization options to personalize your browsing experience.
- **Theme System:** Choose from built-in themes (default, forest, ocean, sunset, cyberpunk, midnight-rose, arctic-ice, cherry-blossom, cosmic-purple, emerald-dream, mocha-coffee, lavender-fields) or create your own custom themes.
- **Live Theme Editor:** Modify colors, gradients, and layout options with real-time preview in the settings.
- **Import/Export Themes:** Share custom themes with the community or use themes created by other users.
- **Non-Destructive Design:** All customizations are stored separately and can be reset to default at any time.
- **Layout Options:** Switch between centered, sidebar, and compact view layouts.
- **Custom Branding:** Personalize the browser title and logo visibility.
For detailed information about creating and managing themes, see the [Customization Guide](Customization.md).
### Cross-Platform
Nebula is built with Electron, allowing it to run on multiple operating systems.
- **Windows, macOS, and Linux:** Enjoy a consistent browsing experience across different platforms.
### Miscellaneous
- **User Agent Strategy:** Electron token is removed from the default user agent to improve site compatibility while appending a `Nebula/x.y.z` marker. You can opt-in to include the Electron token by setting `NEBULA_DEBUG_ELECTRON_UA=1`.
- **Open Local Files:** Use the file picker to open `file://` URLs directly.