Skip to content

Notes.md

Latest commit

 

History

History
220 lines (168 loc) · 11.2 KB

Notes.md

File metadata and controls

220 lines (168 loc) · 11.2 KB
Raw

CRITICAL: navigation to websites do not work at all!!!!!!!!!! Trying to browse to a URL does not function and gives an error:

  • Could not load page preview: The page might be offline, block screenshot services, or the URL may be incorrect. Add right click context menu for modifying the bookmark toolbar, edit favorite, show bookmark tab, show tab groups, etc. Add gitignore for the project (just added to github) and npm i has been ran (need to ignore it and etc.)

Add PWA support with full screen manifest file and all the options. Add support for Cloudflare Pages deployment, as well as support for either using a .env.local and/or Cloudflare Variables and Secrets for the API keys (for AI features), etc.

Fix the error and just fall back to google search on API failure. Uncaught Error: An API Key must be set when running in a browser at new W_ (index-bCi3zYIJ.js:177:78) at index-bCi3zYIJ.js:177:1094Understand this error

Use "models/gemma-3-27b-it" for the conversational, tool call, search agent. See .env.local for the keys and model to use. Enhance the file as you see fit.

  • Work autonomously: Make informed decisions without asking questions
  • Deep research first: Use codebase-retrieval and git-commit-retrieval before every change
  • Validate everything: Never claim completion without running tests and manual verification
  • Document evidence: Provide concrete proof (test results, screenshots, metrics) for every completion
  • No shortcuts: Follow the full validation cycle for every task
  • Quality over speed: Ensure correctness and completeness before moving to next task
  • Incremental progress: Complete one task fully before starting the next
  • No regressions: Existing functionality must continue to work

Note: Work autonomously without asking questions. Prioritize fixes over enhancements. Create unit tests for all new features. Avoid using any type in TypeScript. Use half-circle rounded corners in UI design. Validate all changes with Playwright/Puppeteer tests.

DO NOT claim features are fixed without actually testing them in the running application. The user has clearly indicated that many claimed fixes are not visible or working.

Fix critical bugs and implement enhancements for the Gemini Browser project. Work autonomously following the guidelines below.

CRITICAL BUG FIXES (Priority 1)

1. Navigation to External URLs Completely Broken

Problem: Attempting to browse to any external URL fails with error message: "Could not load page preview: The page might be offline, block screenshot services, or the URL may be incorrect." Required Fix:

  • Investigate why external URL navigation is not working
  • Implement proper error handling and fallback behavior
  • Ensure users can successfully navigate to external websites

2. Missing API Key Error Crashes Application

Error: Uncaught Error: An API Key must be set when running in a browser (thrown at new W_ in index-bCi3zYIJ.js:177:78) Required Fix:

  • Add proper error handling for missing/invalid Gemini API keys
  • Implement graceful fallback to Google search when API fails or key is missing
  • Prevent application crashes due to API configuration issues
  • Display user-friendly error messages instead of uncaught exceptions

ENHANCEMENTS (Priority 2)

3. Add .gitignore File

Context: Project was just added to GitHub and npm install has been run Required: Create a comprehensive .gitignore file that excludes:

  • node_modules/
  • Build output directories (e.g., dist/, build/)
  • Environment files (.env, .env.local, .env.*.local)
  • IDE/editor files (.vscode/, .idea/, *.swp, etc.)
  • OS files (.DS_Store, Thumbs.db)
  • Log files (*.log, npm-debug.log*)
  • Any other standard Node.js/React/Vite artifacts

4. Enhanced Right-Click Context Menus

Add comprehensive right-click context menu options for:

  • Bookmark toolbar: Options to modify, add, remove, or organize bookmarks
  • Individual bookmarks: Edit favorite, rename, delete, change URL
  • Tabs: Show bookmark tab, manage tab groups, pin/unpin tabs
  • Tab groups: Create, rename, delete, change color of tab groups
  • Ensure menus are contextually appropriate based on what is right-clicked

5. Progressive Web App (PWA) Support

Implement full PWA functionality:

  • Create manifest.json with all required fields:
    • App name, short name, description
    • Icons in multiple sizes (192x192, 512x512 minimum)
    • display: "fullscreen" mode
    • Theme color and background color
    • Start URL and scope
    • Orientation preferences
  • Add service worker for offline support
  • Ensure app is installable on desktop and mobile devices
  • Test PWA installation and offline functionality

6. Cloudflare Pages Deployment Support

Implement deployment configuration for Cloudflare Pages:

  • Add necessary build configuration files for Cloudflare Pages
  • Support dual API key configuration methods:
    • Local development: Use .env.local file for GEMINI_API_KEY
    • Production (Cloudflare): Use Cloudflare Environment Variables and Secrets
  • Ensure build process works correctly on Cloudflare Pages
  • Add deployment instructions to documentation
  • Handle API key loading from both sources with proper fallback logic

WORK GUIDELINES

Autonomous Operation:

  • Make informed decisions without asking questions
  • Use codebase-retrieval and git-commit-retrieval extensively before making changes
  • Research existing patterns in the codebase and follow them

Quality Standards:

  • Create unit tests for all new features and bug fixes
  • Avoid using any type in TypeScript - use proper type definitions
  • Use half-circle rounded corners (e.g., rounded-full or specific border-radius values) in UI design
  • Validate all changes with actual testing in the running application

Validation Requirements:

  • Run the application locally and manually verify each fix/feature works
  • Execute all tests and ensure they pass
  • Provide concrete evidence (test results, screenshots, console output) for completion
  • Ensure no regressions - existing functionality must continue to work

Execution Order:

  • Prioritize bug fixes (items 1-2) over enhancements (items 3-6)
  • Complete one task fully with validation before moving to the next
  • Do NOT claim features are fixed without actually testing them in the running application

Issues:

  • Pages are not rendering correctly and things are messed up.

  • If I go to https://www.google.com and try to do a search I get an error:

    "Firefox Can’t Open This Page To protect your security, web-browser.pages.dev will not allow Firefox to display the page if another site has embedded it. To see this page, you need to open it in a new window. Learn more…"

  • Browsing seems laggy, please audit and improve.

  • CSS Styling does not seem to be working.

  • Move the new/plus button (+) to the left side next to the tab.

I added the environment variables from the .env.local file to the Cloudflare environment variables and secrets... but when I try to use it in the deployed version, I get an error page "Gemini API key not found. Using fallback search."

Please audit the code and fix these issues.

Test and validate everything.

Consider detecting if the page render works and if not, fallback to a simple iframe approach (but as I would like to extend the functionality of this tool in the future, I would like to have full control over it).

I don't care about security issues, I would like the app working reliably.

Next: Rename "Gemini Browser" to "TaskWizer Browser" Add ability to edit the bookmakrs with right click (set name, icon, etc.) Allow for dragging/moving the icons around. Add nice icons to each bookmark (placeholder for now, if available, grab the favicon/logo/etc.) Add Google as the first bookmark to the bookmarks toolbar. Add text streaming to the response instead of just a spinner or dump of the data. I decided against Google as the address bar behavior, make it chat with the AI and make suggestions instead.

Get text-streaming working Improve the Markdown rendering Add suggested prompts below and ability to continue the thread.

Move new new tab/+ button to the left side next to the tabs. Add a fullscreen button

Searching on Google fails with error: "browser.cyopsys.com refused to connect."

Add PDF and eBook rendering support. Possible resources for reference:

Integrate uBlock Origin for ad blocking with the ability for the user to customize the options:

Impliment versioning with the build to fix caching issues through the web app. Do code splitting to improve load times and reduce initial load time. Need to be able to drag/move the tabs and bookmarks around. I wanted an animated glow effect to the CHAT input box, not the address bar. Improve the structure of the system and use best practices (for performance, security, etc.)

Critical: The UI looked good and you completely broke it, it looks like a web-browser on linux or from the 90s. Please fix it and restore the styling (overall it was pretty nice). Critical: The web browsing is still not working, audit and fix. Audit and test the application end to end and fix any issues, errors, warnings, etc. and get the web browsing working reliably.

The main app/page is scrolling slightly, fix this (just the browser content within the frame should have scroll). Add Tab groups, and bookmark manager icon and settings to the left of the bookmarks bar. Dragging and dropping tabs and bookmarks do not work. Middle click mouse button on home should open a new home tab. Move the "New Tab" (aka. "+") button to the left side next to the tabs. When the user toggles the tabs to the left virtually, the minimize, maximize, and close buttons on the tabs should also move to the left (cleaning up the top space). Also, make it clear when the toggle is enabled (with a different color or icon, etc.)

Next steps: Priority 2: Performance Optimization (code splitting, PDF/EPUB testing) Priority 3: UI/UX Enhancements (drag-and-drop, glow effect) Priority 4: Code Quality improvements Priority 5: Ad Blocking feature

Typing "Google" into the search bar and pressing CTRL+Enter results is browsing to "https://www.google.com" (assumes .com).

The address bar is glowing, but it should be the chat input box. Cannot drag and drop bookmark icons in the bookmarks bar.

Execution Principles

  • Work autonomously: Make informed decisions without asking questions
  • Deep research first: Use codebase-retrieval and git-commit-retrieval before every change
  • Validate everything: Never claim completion without running tests and manual verification
  • Document evidence: Provide concrete proof (test results, screenshots, metrics) for every completion
  • No shortcuts: Follow the full validation cycle for every task
  • Quality over speed: Ensure correctness and completeness before moving to next task
  • Incremental progress: Complete one task fully before starting the next
  • No regressions: Existing functionality must continue to work