{"id":46188379,"url":"https://github.com/bounswe/bounswe2024group11","last_synced_at":"2026-03-02T23:51:28.443Z","repository":{"id":222619957,"uuid":"756524412","full_name":"bounswe/bounswe2024group11","owner":"bounswe","description":"Developing Turquiz, a platform for Turkish people to get better at English","archived":false,"fork":false,"pushed_at":"2024-10-22T05:01:14.000Z","size":3239,"stargazers_count":11,"open_issues_count":31,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-10-23T07:16:37.192Z","etag":null,"topics":["documentation","english","english-learning","language","learning","quiz","research","software-design","software-engineering","turkish"],"latest_commit_sha":null,"homepage":"https://bounswe.github.io/bounswe2024group11/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bounswe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-12T20:29:40.000Z","updated_at":"2024-10-21T09:15:13.000Z","dependencies_parsed_at":"2024-10-25T14:37:14.458Z","dependency_job_id":"bcedc93e-fd40-4696-9271-db749d7906d6","html_url":"https://github.com/bounswe/bounswe2024group11","commit_stats":null,"previous_names":["bounswe/bounswe2024group11"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/bounswe/bounswe2024group11","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bounswe%2Fbounswe2024group11","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bounswe%2Fbounswe2024group11/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bounswe%2Fbounswe2024group11/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bounswe%2Fbounswe2024group11/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bounswe","download_url":"https://codeload.github.com/bounswe/bounswe2024group11/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bounswe%2Fbounswe2024group11/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30026247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T23:50:51.253Z","status":"ssl_error","status_checked_at":"2026-03-02T23:50:19.316Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["documentation","english","english-learning","language","learning","quiz","research","software-design","software-engineering","turkish"],"created_at":"2026-03-02T23:51:23.851Z","updated_at":"2026-03-02T23:51:28.317Z","avatar_url":"https://github.com/bounswe.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Build \u0026 Run the Application\n\nBelow instructions cover dockerization \u0026 deployment process of our application for users who wants to test/use the application on their local environments.\n\nPlease note that this guide covers this process in the context of **Customer Milestone 3**.\n\n### Pre-Requisites\n\n- Docker\n- Docker-Compose\n- It is sufficient to have the Docker Desktop application for having both of these application above. You can access the necessary document [here](https://docs.docker.com/desktop/).\n\n### Steps\n\nPlease follow this guide step by step in order to create a local build and run the application on the same environment.\n\n#### Clone the Repository\n\n- It is highly recommended to clone our repository on to the environment where the application is going to be built. Then, simple change your directory into the root folder of our repository.\n\n```bash\ngit clone https://github.com/bounswe/bounswe2024group11.git\ncd ./bounswe2024group11\n```\n\n- To have the latest changes included, it is recommended to switch to the `main` branch.\n\n```bash\ngit fetch\ngit checkout main\ngit pull\n```\n\n#### Create `.env` Files\n\n- Our application needs an `.env` files to configure some settings inside its containers during the build process. Since `.env` files are ignored by `.gitignore`, it is required to have these files for local deployment.\n- Make sure that current directory is the root directory of repository.\n\n```bash\ncp ./backend/.env.example ./backend/.env\ncp ./client/.env.example ./client/.env\n```\n\n- If you want to use/test image uploading feature, please fill in the `TINIFY_API_KEY` environment variable's value in the `./backend/.env` file with your API key from [TinyPNG](https://tinypng.com/).\n- If you don't have a `TINIFY_API_KEY`, you can use our sample API key.\n\n```bash\nTINIFY_API_KEY=KJNsyVSbRs0xRCpbbhBjr5PfPDbWS5K6\n```\n\n#### Build \u0026 Run Using `docker-compose`\n\n- After completing steps above, the host machine should be ready for docker builds. It is important to note that users need to install docker-compose program on top of docker itself. It is also recommended to add docker-compose command to the $PATH if it is not configured so.\n- **It is highly recommended to have the Docker Desktop application installed for ignoring the step above.**\n\n- It is important to use the `docker-compose.yml` file for building the application. `-d` flag runs docker-compose in detached mode to not block the shell during the run.\n\n- Below command is sufficient to build \u0026 run the application. Make sure that your Docker Desktop application is running, since below command will require to docker daemon to be up \u0026 running.\n\n```bash\ndocker-compose -f docker-compose.yml up --build -d\n```\n\n#### Mobile Usage on Android via Expo\n- Follow the instructions [here](https://reactnative.dev/docs/set-up-your-environment) to set your environment ready to develop using React Native.\n- Install Expo CLI globally\n```bash\nnpm install -g expo-cli\n```\n- Install Expo Go on your Android device from the Google Play Store if it's not installed automatically.\n- Navigate to the **mobile** folder.\n```bash\ncd ./mobile\n```\n- Install dependencies for the mobile application:\n```bash\nnpm install\n```\n- Start the Expo development server:\n```bash\nnpx expo start\n```\n- Press a.\n- Ensure your Android emulator is connected to the same Wi-Fi network as your development machine.\n\n#### View the Running Application\n\n- You can use Docker Desktop application for viewing running containers and their conditions.\n- You can simply browse \"http://localhost\" for viewing the homepage of our client application for further use.\n\n#### Closing the Running Application\n\n- Again, Docker Desktop application is sufficient to stop or remove the built containers, images, builds and volumes.\n- Or you can use the shell for this purpose.\n\n```bash\ndocker ps # see running containers with their info\ndocker-compose down # stop and remove running containers\ndocker image prune -a # remove all images built\n```\n\n#### Standards\n\nIn LAB-5, the team made significant efforts to document and adhere to the project's standards, namely WAI-ARIA, WCAG, and SVG.\n\nResponsible individuals: Arda Vural, Hasan Kerem Seker, M. Emin Ciftci, Umit Can Evleksiz.\n\n#### Checklist Items for Lab 8\n\nPrimary features (e.g. semantic search, user management),\nDomain-specific features (e.g. why they're specific, how they're implemented),\nAPI and its documentation (e.g. endpoints, expected inputs, outputs),\nStandard(s) being followed (e.g. its documentation, implementation),\nTesting strategies (e.g. unit test coverage, integration testing, tools).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbounswe%2Fbounswe2024group11","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbounswe%2Fbounswe2024group11","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbounswe%2Fbounswe2024group11/lists"}