Merge dev to main before delivery

.gitignore

@@ -0,0 +1,25 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+coverage/

README.md

@@ -1,24 +1,87 @@
-# T12-Project-1
+# T12 - Project - 1 - Rick and Morty character explorer
 
-Repository for team IT2810-H26-T12 in IT2810-H26.
+## Virtual machine
 
-## Working in this repository
+The webpage can be accessed through a virtual machine at:
 
-`main` is protected — you cannot push to it directly. Work on a branch and
-open a pull request:
+- http://it2810-12.idi.ntnu.no/project1/
+
+## Overview
+
+This project collects and displays data from an external REST API for the popular TV show _Rick and Morty_. To demonstrate the application's functionality and navigation without using an unnecessarily large dataset, only the first page of characters is fetched from the API. Users can search for and filter characters using the search bar or filter menu. More detailed information about each character can be viewed by clicking the `Details` button. Each character card also has a star button that allows users to add characters to their favorites.
+
+The API documentation can be found here:
+
+- https://rickandmortyapi.com/documentation
+
+## Get started
+
+Before running the project, make sure you have `Node.js v24.6.X+` and `npm v11.+` installed on your machine. Install the project dependencies with:
+
+```bash
+npm install
+```
+
+Start the development server with:
+
+```bash
+npm run dev
+```
+
+The webpage will then be available at the local URL provided in the terminal (localhost:5173)
+
+## Tests
+
+The project has a test line coverage of 86%. To measure and review the current test coverage, run the following command in the terminal:
 
 ```bash
-git checkout -b my-feature
-git push -u origin my-feature
+npm test -- --coverage
 ```
 
-Before a pull request can be merged:
+Each component has its own test file covering its most important functionality. `CharactersPage.tsx` also has a separate test file that covers the main functionality of the page. `HeroPage.tsx` consists only of static HTML elements and does not contain any functionality that requires testing. The test files are located in the same folders as their corresponding components or pages and follow the same naming convention. To run project tests run the following command in the terminal:
+
+```bash
+npm test
+```
+
+We performed manual testing for responiveness and user experience. This was done in both landscape and portrait orientations on the following devices:
+
+- iPhone 16
+- iPhone 17
+- iPhone 13
+- iPad Air
+- Macbook Air
+- Macbook Pro
+
+## Developed by
+
+- Emma Fredriksen
+- Mina Ellingsen
+- Karen Skauge
+- Gurveer Singh
+
+## Technologies
+
+The project was developed using the following technologies and tools:
+
+- React
+- Vite
+- TypeScript
+- TanStack Query
+- HTML and plain CSS
+- Vitest
+- Prettier
+
+## Technical choices
+
+The webpage is divided into smaller React components to seperate responsibilities and make the code easier to understand, maintain and test. React state is used for data that changes during user interaction, such as the selected character, search query, and filters, while props are used to pass data and functionality between components. Character and episode data is fetched from the Rick and Morty REST API using TanStack Query. TanStack Query was chosen to handle asynchronous API requests and caching, reducing the need to manually manage loading and fetched data in React state. API data is fetched when needed and is not persisted in Web Storage.
+
+Web Storage is used for user-specific choices. Filter selections are stored in `sessionStorage`, allowing them to survive page reloads during the same browser session. Favorites are stored in `localStorage` so that they remain available after the browser has been closed and reopened. This also allowed us to gain experience with the different persistence behavior of the two storage APIs.
+
+The user interface is built with our own React components and plain CSS, without third-party UI component libraries. CSS, Flexbox, and media queries are used to adapt the layout to different screen sizes and orientations.
+
+## Use of AI
+
+During development, our use of AI has been limited. Any code written with the assistance of AI is marked with a comment above the relevant code snippet. We chose this approach based on our understanding of AI and our previous experience. AI can be a great accelerator when programming, but using it effectively requires a good understanding of the fundamental principles behind the technology being used. Without this understanding it is hard to evaluate the code produced by AI and make informed decisions. Since we are still developing our understanding of React, TypeScript and the other technologies used in this project, we decided it was better to use AI as a coach rather than a developer. This approach affected our development speed, and we spent more time exploring documentation and other learning resources. However, it also gave us a better understanding of the project as a whole and helped us avoid introducing unnecessary code that we did not fully understand or know how to maintain.
 
-1. **A member of IT2810-H26-T12 must approve it.** You cannot approve your own pull
-   request, and approvals from staff do not count — you review each other's
-   code.
-2. **Every review comment must be marked resolved.** Reply to each one, fix it
-   or explain why not, then click *Resolve conversation*.
-3. **Pushing new commits dismisses the approval**, so if you change something
-   after being approved, ask for another review. This is deliberate: what was
-   approved is what gets merged.
+We also found that establishing a shared standard for documenting AI-assisted code made it easier to be transparent about the use of AI and to review each other's work. Knowing which parts were developed with AI assistance made it easier to discuss the reasoning behind the code and evaluate whether we understood and agreed with the proposed solutions. At the same time, we recognize that we could probably have achieved a higher development speed by using AI more actively, and AI might also have helped us identify more efficient solutions in some areas. However, for this project, we felt that the benefits of prioritizing learning, transparency, and understanding outweighed the potential increase in productivity. We therefore intend to continue using this approach while gradually increasing our use of AI as our own knowledge and ability to evaluate its output improve.

eslint.config.js

@@ -0,0 +1,22 @@
+import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import tseslint from "typescript-eslint";
+import { defineConfig, globalIgnores } from "eslint/config";
+
+export default defineConfig([
+  globalIgnores(["dist"]),
+  {
+    files: ["**/*.{ts,tsx}"],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      globals: globals.browser,
+    },
+  },
+]);

index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Rick and Morty Character Explorer</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>