Stellenbeschreibung:

SUMMARY
We’re seeking a skilled React/TypeScript developer to help us address technical debt and improve the structure of our web application. You’ll refactor backend API interactions, modularize UI components, and implement robust test coverage — all while preserving the existing UI/UX and functionality.


STACK
Next.js 14 with App Router
TypeScript
TailwindCSS
Radix UI
Zustand
React Hook Form
Axios
Jest
React Testing Library

Our backend provides an openAPI json and the frontend uses automatically generated backend services.


TASKS

• (1) Take inventory of the repository and suggest any tasks you see in addition to the following list.


• (2) remove all code that isnt in use


• (3) Make a suggestion for a normal repository structure in chat, after discussion and refinement of the structure: please transfer the existing code to the new directory structure while preserving the current code. It's ok to split up files but the code should remain mostly unchanged. The structure needs to differentiate between /external and /internal code.


• (4) Set up any test setup needed and missing for unit testing with Jest and E2E testing with Cypress; this will serve as preparation for the next step.


• (5) Component Extraction and Modularization:
  Refactor /pages by extracting individual components (/comps) following best practices.
  Identify and separate reusable UI and logic into standalone components.
  Ensure each new component is accompanied by intuitive unit or integration tests achieving at least 80% coverage.
  Remove duplication and recombine pages using the new modular components to maintain existing functionality and styling.


• Use a dedicated branch per component, including:
  
  • The new component
  
  
  • Refactored usage in pages
  
  
  • Associated tests


Acceptance Criteria:

• ✅ Visual and Functional Parity: All pages must look and behave exactly as they do now (pixel-perfect).


• ✅ Zero Bugs: No regressions or new runtime errors introduced.


• ✅ Typed API Layer: All API interactions must use a reusable, type-safe pattern (generated from OpenAPI).


• ✅ Reusable Components: Shared UI elements must be refactored into clean, well-structured components.


• ✅ Composition: The existing pages must be refactored as a composition of reusable components.


• ✅ Test Coverage: All reusable components must have unit or integration tests with over 80% coverage.


• ✅ Code Quality: Code must pass existing ESLint, Prettier, and CI test suite with no warnings or errors.


• ✅ Well-Documented PRs: Each PR must be clearly documented (summary, what was refactored, testing notes).


🧠 Ideal Candidate:
3+ years React/TypeScript experience
Familiar with design systems
Comfortable with API typing (OpenAPI tooling)
Strong test-driven development mindset
Clean, modular code practices


Ground Rules for our collaboration:
The work must be done on bounded branches with dedicated changes; i.e., when you want to implement a certain standard, bundle the changes for this on one branch and open an MR to stage. Do NOT mix different tasks on one branch.
Interfaces must start with an I, i.e., IChat, ISomething.
Keep MRs small and reviewable.
Review your own code before you ask for review by our team.


There is ample opportunity for follow-up work if this job goes well. We are looking to extend the scope of the existing application over the coming months.

NOTE / HINWEIS:

EN: Please refer to Fuchsjobs for the source of your application

DE: Bitte erwähne Fuchsjobs, als Quelle Deiner Bewerbung