- Fork this repo to your local Github account.
- Create a new branch to complete all your work in.
- Write tests to ensure you've completed the requirements
- Create a Pull Request against the main branch when you're done and all tests are passing
The goal of this project is to implement a stopwatch application using React and TypeScript. The stopwatch should have the following functionality:
- Start the stopwatch to begin counting time.
- Stop the stopwatch to pause the timer.
- Displays Laps when a button is pressed.
- Reset the stopwatch to zero.
You will be provided with a basic project structure that includes the necessary files and dependencies. Your task is to write the code to implement the stopwatch functionality and ensure that it works correctly.
To get started with the project, follow these steps:
-
Clone the project repository to your local development environment.
-
Install the required dependencies by running npm install in the project directory.
-
Familiarize yourself with the project structure. The main files you will be working with are:
- src/App.tsx: The main component that renders the stopwatch and handles its functionality.
- src/Stopwatch.tsx: A separate component that represents the stopwatch display.
- src/StopwatchButton.tsx: A separate component that represents the start, stop, and reset buttons.
-
Review the existing code in the above files to understand the initial structure and component hierarchy.
Your specific goals for this project are as follows:
-
Implement the stopwatch functionality:
- The stopwatch should start counting when the user clicks the start button.
- The stopwatch should stop counting when the user clicks the stop button.
- The stopwatch should reset to zero when the user clicks the reset button.
- The stopwatch should record and display laps when user clicks the lap button.
-
Ensure code quality:
- Write clean, well-structured, and maintainable code.
- Follow best practices and adhere to the React and TypeScript coding conventions.
- Pay attention to code readability, modularity, and performance.
-
Test your code:
- Write unit tests for the stopwatch functionality to ensure it works correctly.
- Verify that the stopwatch starts, stops, resets, and records laps as expected.
-
Code documentation:
- Document your code by adding comments and explanatory notes where necessary.
- Provide clear explanations of the implemented functionality and any important details.
-
Version control:
- Use Git for version control. Commit your changes regularly and push them to a branch in your forked repository.
-
Create a Pull Request:
- Once you have completed the project goals, create a pull request to merge your changes into the main repository.
- Provide a clear description of the changes made and any relevant information for the code review.
To start working on the project, follow these steps:
-
Clone the repository to your local development environment.
-
Install the required dependencies by running npm install in the project directory.
-
Open the project in your preferred code editor.
-
Review the existing code in the src directory to understand the initial structure and component hierarchy.
-
Implement the stopwatch functionality by modifying the necessary components (App.tsx, Stopwatch.tsx, StopwatchButton.tsx).
-
Run the application using npm start and test the stopwatch functionality.
-
Commit your changes regularly and push them to a branch in your forked repository.
-
Once you have completed the project goals, create a pull request to merge your changes into the main repository.
Here are some resources that may be helpful during your work on this project:
-
React Documentation - Official documentation for React, providing detailed information on React concepts and usage.
-
TypeScript Documentation - Official documentation for TypeScript, offering guidance on TypeScript features and usage.
-
React Testing Library - Explore React Testing Library, a popular testing library for React applications.