
Closed
Posted
Paid on delivery
We have an existing **Progressive Web App built in React that is already live and being used**, but the codebase grew quickly during the initial development phase. We are now looking for an experienced React developer/engineer to step in, understand the existing system, clean up the architecture, resolve technical issues, and complete several unfinished or unreliable features. **This is not a greenfield project and we do not want the application rebuilt from scratch.** The goal is to take what already works, preserve it, remove unnecessary complexity, fix weak areas properly, and leave us with a clean, stable, scalable codebase that another developer can easily maintain in the future. ### What We Need The first step will be to review the existing repository and understand how the application currently works before making major changes. The main responsibilities will include: * Audit the existing React application and identify messy, duplicated, unnecessary, or fragile code. * Refactor React components, hooks, utilities, state logic, API/service layers, routing, and supporting files where necessary. * Simplify overly complicated logic without changing working functionality. * Remove dead code, unused dependencies, duplicate implementations, temporary fixes, and unnecessary workarounds. * Improve folder structure, naming conventions, reusable components, and separation of concerns. * Diagnose existing console errors, warnings, failed requests, runtime issues, and browser-specific problems. * Fix the **root cause** of bugs instead of simply suppressing errors. * Review and improve the current service-worker and Workbox implementation. * Complete unfinished functionality already present within the application. * Improve general performance, reliability, error handling, and maintainability. * Ensure changes do not introduce regressions into features that are currently working. ### Priority Features Three areas currently require particular attention: **1. Authentication & Session Management** Authentication needs to work reliably across login, logout, session restoration, protected routes, refreshes, expired sessions, and different user states. We want authentication logic to be centralized, predictable, secure, and easy to maintain. **2. Progressive Web App / Offline Functionality** The app should behave like a proper PWA. This includes reviewing: * Service worker registration * Workbox configuration * Cache strategies * Static asset caching * Runtime caching * Offline fallback behaviour * App updates * Cache invalidation * Version changes * Network failures * Reconnection behaviour Users should not experience broken screens or stale application versions because of incorrect caching. **3. Push Notifications** Review the existing push-notification implementation and complete or repair it so notifications work reliably. This includes browser permissions, token/subscription management, service-worker handling, foreground/background behaviour, and notification interaction where applicable. ### Existing Stack The application currently uses: * React * Create React App * JavaScript * HTML * CSS * Progressive Web App architecture * Service Workers * Workbox You will receive repository access along with documentation explaining the current application structure, routing, known problems, and areas of the codebase that require the most attention. Screenshots, console errors, reproduction steps, and additional technical context can also be provided. ### Important Development Approach We are specifically looking for someone who can **understand an existing system before changing it**. We do not want someone to immediately rewrite the application, replace major technologies, or introduce unnecessary frameworks simply because they prefer another stack. Where architectural changes are recommended, explain: * What the current problem is * Why the change is necessary * What risk it solves * Whether it could affect existing functionality Major architectural changes should be discussed before implementation. The application is already live, so changes must be made carefully and tested properly. ### Deliverables By completion, we expect: 1. **Codebase Audit** * Clear identification of major technical problems, unnecessary complexity, duplication, and architectural weaknesses. 2. **Refactored Codebase** * Cleaner React components and hooks * Better organization * Reduced duplication * Removal of unnecessary code * Improved error handling * Clear comments only where they genuinely help explain non-obvious logic 3. **Bug Resolution** * Existing console/runtime errors investigated and fixed at their source. 4. **Working Authentication** * Reliable authentication, sessions, protected routes, logout/login behaviour, and state restoration. 5. **Reliable PWA / Offline Support** * Proper service-worker behaviour * Predictable caching * Offline functionality * Correct application updating/version behaviour 6. **Working Push Notifications** * Proper registration, permission handling, subscriptions/tokens, foreground/background behaviour, and notification interaction. 7. **Browser Verification** * Core functionality verified in the latest versions of Chrome and Microsoft Edge. * Mobile/PWA behaviour should also be checked where applicable. 8. **Regression Testing** * Existing working functionality should remain functional after refactoring. 9. **Change Log** * A concise summary explaining: * What was changed * Why it was changed * Bugs discovered * Bugs resolved * Remaining technical debt * Recommended future improvements 10. **Clean Repository Handover** * Final code committed in a structured manner with meaningful commit messages and no unexplained temporary/debug code left behind. ### Who We Are Looking For This project is best suited for a **senior React developer or full-stack JavaScript engineer with strong debugging and architecture skills**, rather than someone who mainly builds basic React interfaces. Strong experience with the following is highly preferred: * Maintaining and refactoring existing production React applications * React architecture and hooks * JavaScript debugging * Progressive Web Apps * Service Workers * Workbox * Browser caching strategies * Authentication/session management * Web push notifications * Chrome DevTools * Performance/debugging tools * Git and structured production workflows Experience troubleshooting complicated existing codebases is especially important. ### When Applying Please briefly explain: * Your experience repairing or refactoring an existing React application rather than building one from scratch. * A PWA, service-worker, offline-cache, or push-notification project you have worked on. * How you normally approach an unfamiliar production codebase before making changes. * How you would diagnose service-worker/cache problems without disrupting existing users. * Whether you are comfortable documenting technical debt and recommending a phased cleanup instead of unnecessarily rewriting the application. Please include relevant GitHub repositories, portfolio work, or examples if available. Generic proposals will not be prioritized. We are looking for someone who can **take ownership of the technical quality of the application, understand why problems are happening, clean up what already exists, and help us move from a rushed first release to a stable production-grade platform.**
Project ID: 40719951
243 proposals
Remote project
Active 3 days ago
Set your budget and timeframe
Get paid for your work
Outline your proposal
It's free to sign up and bid on jobs
243 freelancers are bidding on average $154 CAD for this job

A live React PWA that already works in parts usually gets risky when auth, caching, and push logic have been patched in different places over time. The real issue is not just fixing visible bugs, but untangling state flow, service-worker behavior, and side effects without breaking working paths. My first step would be a structured audit of the repo, runtime warnings, network flow, auth lifecycle, and cache/update behavior before touching the architecture. I’ve worked on production React applications where the job was cleanup and stabilization rather than rebuilding from scratch, including refactoring hooks/components, tracing session bugs, and resolving stale-cache and service-worker issues that were causing inconsistent user behavior. I’m also comfortable documenting technical debt and recommending phased fixes when a full rewrite would create more risk than value. - Is the current auth flow token-based, cookie-based, or mixed? - Are push notifications using Firebase/web-push or a custom subscription flow? - Do you already have a list of the unreliable features and known browser-specific issues to prioritize in phase one?
$250 CAD in 7 days
8.8
8.8

Hi, I’ve read the full scope and understand the key requirement: preserve the existing live React application, understand it first, and improve it without an unnecessary rewrite. My first step would be a repository audit before making architectural changes. I’ll map the current component/hook structure, routing, state/auth flow, API layer, service worker/Workbox configuration, push implementation and dependencies, then reproduce the documented errors before changing them. For PWA/cache issues, I would inspect service-worker lifecycle and registration, Workbox strategies, cache names/versioning, update activation, runtime caching and network/offline behaviour. Changes would be tested carefully so existing users aren't left running stale or incompatible cached builds. The implementation phase will focus on: • authentication/session restoration and protected routes • service worker, Workbox, offline behaviour and updates • push registration/subscriptions and foreground/background handling • root-cause fixes for console/runtime/API errors • safe React refactoring and removal of duplicate/dead code • Chrome/Edge/mobile PWA and regression testing • structured Git commits, changelog and documented remaining technical debt Fixed price: $600 USD Estimated timeline: 10–14 days I can begin with the audit as soon as repository access and the existing technical documentation are available. I’ll add relevant GitHub/PWA examples from my actual work to the application. Thanks
$750 CAD in 10 days
8.3
8.3

With hands-on experience in React and a knack for streamlining complex codebases, I can help enhance your existing Progressive Web App. My past projects involved similar tasks, ensuring smooth transitions without rebuilding from scratch. How can we align on the priority areas for cleanup and enhancement to maintain functionality while improving stability and scalability? Regards, Yogesh Kumar
$60 CAD in 6 days
8.1
8.1

Hi there, I can audit and improve your existing React PWA without rebuilding it from scratch. I’ll first understand the current architecture, then fix the root causes behind authentication, service-worker/Workbox caching, offline behaviour and push notifications, while removing unnecessary code and improving maintainability without breaking working features. I have an experienced React team and can provide a clear audit, clean commits, regression testing and change log. Could you share the repository and known-issue notes so I can review the current codebase and identify the highest-priority fixes? Kindly send me a message to discuss more or directly award me. Thank you!
$180 CAD in 4 days
8.1
8.1

Hello, We can help stabilize and clean up your existing production React PWA without unnecessarily rebuilding or replacing the current architecture. Our approach: * First audit the repository, architecture, dependencies, routing, state logic, API layer, service worker, and existing issues. * Reproduce console errors, runtime failures, failed requests, and browser-specific problems before changing code. * Refactor duplicated or fragile components, hooks, utilities, and services while preserving working functionality. * Review authentication, session restoration, protected routes, logout, refresh, and expired-session handling. * Audit Workbox/service-worker registration, caching, invalidation, offline fallback, updates, and reconnection behaviour. * Diagnose push notification permissions, subscriptions, service-worker handling, and foreground/background behaviour. * Complete unfinished functionality already present in the codebase. * Test Chrome, Edge, mobile/PWA scenarios, and existing workflows to prevent regressions. * Use structured Git commits and document changes, technical debt, remaining risks, and recommendations. We prefer phased cleanup: audit first, then prioritized fixes and refactoring, with major architectural changes discussed before implementation. Regards, Chanchal CnEL India
$140 CAD in 15 days
8.2
8.2

I see you're looking for a developer to refine your existing PWA built in React. Given the focus on authentication and offline functionality, I know how critical it is to make sure that these features work smoothly without introducing regressions. Many developers overlook those intricacies of service worker caching, which can lead to stale content or broken states, especially during updates, I’ll start with a thorough audit of your codebase to pinpoint weaknesses and plan a careful refactor. And my approach involves understanding your current architecture deeply before making changes. I’ll focus on kind of simplifying complex logic, fixing bugs at their source, and making sure that the authentication flow is solid and predictable. I’m ready to help stabilize your application and improve its maintainability, so let's get this going. I’m ready to get started on this right away. Rajavel | React Developer | PWA | Service Workers
$30 CAD in 1 day
7.5
7.5

Hi, This project requires careful analysis and refactoring of a live React PWA with a focus on stabilizing authentication, offline support, and push notifications. The main engineering risk lies in preserving existing functionality while improving the service worker and session management to prevent regressions. I usually structure work on legacy React apps by first auditing the codebase to identify fragile or duplicated logic, then refactoring incrementally with thorough testing. I have experience extending and improving existing React systems, as demonstrated in my Custom Feature Development & Integration project where I conducted detailed code reviews and implemented maintainable enhancements. I recommend separating concerns clearly between authentication logic, caching strategies, and UI components to isolate risks and simplify debugging. For the service worker, precise cache invalidation and update mechanisms are critical to avoid stale content or broken offline states. I approach systems by emphasizing root cause fixes rather than quick patches, ensuring long-term maintainability and stability in production. I would first validate the current session and cache flows before proposing architectural improvements. Thanks, Hercules
$250 CAD in 7 days
7.5
7.5

This looks like a production cleanup job where the biggest risk is changing too much too early and creating regressions in a live app. When React state, auth restoration, and Workbox caching grow quickly, bugs tend to appear as “random” failures even though the root cause is structural. I’d handle it by mapping the current architecture first, isolating fragile areas, and then repairing them in controlled passes. I’ve been involved with existing React/PWA projects where the work centered on debugging real production behavior: console/runtime issues, stale assets after deploys, broken offline states, route protection edge cases, and notification flow problems between foreground and background contexts. I’m comfortable working inside the current stack, documenting technical debt, and justifying architectural changes before making them. - Which of the three priorities is blocking you most right now: auth, offline/PWA behavior, or push notifications? - Are there known reproduction steps for the session and caching problems? - Do you want the cleanup delivered in one pass, or would a reviewed audit-first phase suit you better?
$250 CAD in 7 days
7.3
7.3

Hello, I see you're looking for a senior React developer to tidy up your existing Progressive Web App and complete outstanding features. With 7+ years of experience in maintaining and refactoring production React applications, I can dive into your codebase, identify the messy areas, and streamline the architecture without rebuilding it from scratch. My approach involves thoroughly auditing the current system, fixing bugs at their source, and enhancing functionality, especially around authentication, offline support, and push notifications. I understand the importance of maintaining a stable application for your users, so I’ll ensure that any changes are carefully tested to avoid regressions. You can view my work here: https://pixoriq.com. What specific challenges have you encountered with the service-worker and caching strategies that I should be aware of? Best regards, Ivan Mandinski
$140 CAD in 2 days
7.4
7.4

Hello, this production React/PWA cleanup project is exactly the kind of careful engineering work that benefits from diagnosis before changes. I would begin with a repository audit, reproduce issues, map authentication, service-worker, Workbox, caching, and notification flows, then document risks and propose a phased plan before refactoring. I’m comfortable preserving working behavior while addressing root causes, improving maintainability, validating Chrome, Edge, and mobile/PWA behavior, and providing clear commits, regression checks, and a practical change log. I would also recommend staged service-worker releases with rollback awareness to protect active users. Check out my portfolio here:- https://www.freelancer.com/u/installerpoint Best Regards, Muhammad Adeel
$80 CAD in 4 days
7.0
7.0

HEY I HAVE WORKED ON SIMILAR PRODUCTION REACT & PWA REFACTORING PROJECTS — I CAN CLEAN UP YOUR EXISTING CODEBASE WITHOUT REBUILDING WHAT ALREADY WORKS. I understand you need a senior React engineer to take ownership of an already-live application, first understand the existing architecture, then systematically fix root causes and improve maintainability. For service-worker and caching issues, I would diagnose the current lifecycle and cache behaviour first, make controlled changes, verify updates/versioning and avoid disruptive changes for existing users. I am comfortable documenting technical debt and proposing phased improvements rather than forcing a rewrite. Stack: React, JavaScript, CRA, HTML/CSS, Workbox, Service Workers and PWA APIs. You will receive clean commits, updated source code, audit/change documentation and a stable handover. I can also provide relevant examples of similar work and offer 2 years of free ongoing support post-launch. Thanks karuna
$140 CAD in 7 days
7.1
7.1

Hi, I went through your project details and understand what you're looking to achieve. I'd be interested in working with you on this. Based on the requirements you've shared, I can handle the project from start to completion while keeping the work aligned with your expectations, timeline, and desired outcome. My approach is straightforward: first, I'll make sure the requirements and expected deliverables are clear. Then I'll complete the work in structured stages, share progress along the way, incorporate your feedback, and deliver the final work after everything has been reviewed. Before we begin, I have a couple of questions about your requirements that will help me understand the scope more accurately. Feel free to message me so we can discuss the details and determine the best way to move forward. Best regards, Anum
$250 CAD in 1 day
6.8
6.8

Hi, I specialize in debugging and refactoring existing React applications without unnecessary rewrites. I’d first audit the architecture, state/auth flow, service worker, Workbox caching, push notifications, console/runtime errors, and dependencies, then fix root causes incrementally with regression testing. For PWA issues, I’d inspect registration, cache/version lifecycle, update behavior, and offline/runtime strategies carefully so existing users aren’t disrupted. I’ll keep changes focused, document technical debt and remaining risks, and deliver a clean repository with meaningful commits and a clear change log. 1. Is authentication currently handled through a specific provider/library, or is it custom? 2. Is the push system based on Firebase Cloud Messaging, Web Push/VAPID, or another service? 3. Are service-worker/cache issues reproducible in production only, or can they also be reproduced in a staging environment? Regards, Houssame
$30 CAD in 1 day
6.3
6.3

Your main challenge is preserving a live React PWA while removing the shortcuts that now make auth, offline behavior, and notifications unreliable. In this kind of codebase, the damage usually comes from duplicated logic, fragile state handling, and service-worker caching rules that hide the real source of bugs. I would start by auditing the existing flow carefully, then refactor only where the risk and payoff are clear. Most of my relevant work has been in fixing and improving existing JavaScript/React systems already in use, not replacing them just because the structure is messy. That includes tracing protected-route/session issues, reviewing Workbox/service-worker setup, cleaning API/state layers, and tightening browser behavior so the app becomes predictable for both users and future developers. I can also leave you with a concise cleanup log and phased recommendations if some debt should be handled in stages. - Is the repo still on standard Create React App service-worker wiring, or has that part already been customized? - Do you have staging available for testing auth, cache invalidation, and push flows safely before production release?
$250 CAD in 7 days
6.5
6.5

Hi, Warm greetings from the Syndell team! Your production React PWA needs architectural cleanup to eliminate duplicated components, simplify state logic, and complete unreliable features. We'd start by auditing the codebase to map where complexity accumulated, then refactor methodically in phases while preserving working functionality. We specialize in inherited production systems: we know how to engineer refactors safely and leave your team with clean, maintainable code. What are the top 2-3 issues - component duplication, state management complexity, or unreliable features - creating the most friction for your team? With 5-star reviews on Clutch and GoodFirms and a top-rated standing for our services on Freelancer.com, we bring an experienced team of developers, designers, and marketers to every engagement. We would love to connect, hear more about your priorities, and share the most relevant pieces of our past work. Excited about this opportunity. Thanks! PS: The final time and cost may be subject to change based on our discussion.
$30 CAD in 7 days
6.5
6.5

Hi, I'm Denis, a full-stack developer specializing in maintaining and refactoring production React applications. I understand codebases that grew quickly, accumulated technical debt, and need stabilization without complete rewrites. I've worked on similar systems where the challenge was understanding existing architecture, removing complexity, and improving maintainability. This includes PWA implementations with service workers and Workbox, plus authentication systems that work reliably across sessions and refreshes. My approach to unfamiliar production codebases is consistent: audit first, understand design decisions, then refactor incrementally. I'll review your repository structure, trace data flow, identify duplicated or over-engineered components, and find root causes of errors. For service-worker and cache issues, I diagnose using Chrome DevTools and test thoroughly in staging before production. I'm pragmatic about architectural issues—not everything needs immediate fixing. I'll document technical debt clearly, distinguish between stability blockers and phased improvements, and recommend changes only when they genuinely reduce risk or maintainability. Your three priorities—authentication, PWA behavior, and push notifications—need careful refactoring. I'll ensure they work reliably across edge cases and leave you with clear documentation of changes and rationale. Ready to start immediately. Let's discuss the details. Thanks, Denis.
$30 CAD in 2 days
6.3
6.3

Hi, I’d begin with a repository audit and reproduce the documented issues before refactoring any working production behaviour. I’ll trace authentication/session state, service-worker registration and Workbox caching separately, then document the root cause and regression risk before making structural changes. For PWA issues, I’ll verify cache versions, runtime strategies, update lifecycle, offline/reconnection behaviour and push subscription handling rather than masking browser errors. Refactoring will be incremental with focused testing so existing functionality remains stable while duplicated or fragile logic is removed. I’ll finish with structured commits and a change log covering fixes, remaining technical debt and recommended follow-up work.
$250 CAD in 10 days
6.3
6.3

Hi. Would you prefer to audit the current authentication flow first, or start with the Workbox cache configuration? Stabilizing a live React progressive web app without breaking existing features requires careful incremental refactoring. A major challenge is updating service worker caching strategies while active users still have stale assets loaded. The solution involves setting up isolated staging environments and implementing version-based cache invalidation headers. Would you rather review the codebase architecture on a quick call, or check previous similar refactoring work first? Drop a quick message to coordinate the initial repository review and map out the next steps.
$250 CAD in 7 days
5.9
5.9

Hi, I am Adeel. I built Boostifai, a multi-tenant SaaS with a React frontend and a service worker driven embedded script running live on client sites, so I have dealt with cache invalidation and stale versions in production PWAs. For yours I would start with an audit pass: map the auth flow, service worker registration and push subscription handling before touching code, then fix root causes rather than symptoms. Given the scope, I would prioritize the authentication and PWA caching issues first since those cause the most visible breakage, then move to push notifications. Which of the three priority areas is causing the most user complaints right now?
$30 CAD in 1 day
6.2
6.2

Hi there. Jumping into a messy, fast-growing React codebase without breaking what is already live is a delicate task, and it is exactly what I specialize in. Instead of suggesting an unnecessary rewrite, I focus on auditing, diagnosing root causes, and systematically stabilizing existing production applications. I have extensive experience refactoring complex React architectures, optimizing Workbox and service-worker caching strategies, and fixing bulletproof authentication and push notification flows. Here are my questions: 1. Are you currently using a specific backend or third-party service like Firebase or Auth0 for your session management? 2. Do you have a prioritized list of the existing console errors or specific edge cases users run into most frequently with the current offline cache? Drop me a message so we can get started right away.
$250 CAD in 5 days
6.1
6.1

Kitchener, Canada
Member since Sep 18, 2026
$30-250 CAD
₹37500-75000 INR
$700-751 USD
₹12500-37500 INR
min $50 USD / hour
₹100-400 INR / hour
₹5000-10000 INR
₹600-700 INR
₹600-601 INR
₹12500-37500 INR
$250-750 USD
₹600-1500 INR
₹150000-250000 INR
₹600-1500 INR
₹12500-37500 INR
₹12500-37500 INR
$250-750 USD
$30-250 USD
₹750-1250 INR / hour
₹150000-250000 INR