{"id":18976269,"url":"https://github.com/behzodfaiziev/stepwise-backend","last_synced_at":"2026-04-11T04:32:17.783Z","repository":{"id":259610932,"uuid":"877942879","full_name":"behzodfaiziev/stepwise-backend","owner":"behzodfaiziev","description":"StepWise Backend","archived":false,"fork":false,"pushed_at":"2025-02-22T14:52:21.000Z","size":63,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-12T09:37:28.686Z","etag":null,"topics":["docker","docker-compose","postgresql","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","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/behzodfaiziev.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,"zenodo":null}},"created_at":"2024-10-24T14:03:28.000Z","updated_at":"2025-02-22T14:52:24.000Z","dependencies_parsed_at":"2024-10-26T22:15:57.873Z","dependency_job_id":"de1c3fa4-aade-4ba1-a62d-a010beb1a624","html_url":"https://github.com/behzodfaiziev/stepwise-backend","commit_stats":null,"previous_names":["behzodfaiziev/stepwise-backend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/behzodfaiziev/stepwise-backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/behzodfaiziev%2Fstepwise-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/behzodfaiziev%2Fstepwise-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/behzodfaiziev%2Fstepwise-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/behzodfaiziev%2Fstepwise-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/behzodfaiziev","download_url":"https://codeload.github.com/behzodfaiziev/stepwise-backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/behzodfaiziev%2Fstepwise-backend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31669114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["docker","docker-compose","postgresql","spring-boot"],"created_at":"2024-11-08T15:23:20.298Z","updated_at":"2026-04-11T04:32:17.756Z","avatar_url":"https://github.com/behzodfaiziev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Project Setup\n\nThis project consists of a Spring Boot backend and a PostgreSQL database. Docker and Docker Compose\nare used for containerization to streamline setup and configuration.\n\n## Prerequisites\n\n- Docker installed on your system\n- Docker Compose installed\n    - (Optional) IntelliJ IDEA or another IDE for Java development\n- Note: sudo is required for Linux and MacOS users to run Docker commands, but not for Windows\n  users.\n\n## Getting Started\n\n### 1. Clone the Repository\n\nClone this repository to your local machine:\n\n```shell\ngit clone https://github.com/behzodfaiziev/stepwise-backend\ncd https://github.com/behzodfaiziev/stepwise-backend\n```\n\n### 2. Configure Environment Variables\n\nCreate a .env file in the root of the project with the following content:\n\n```shell\nPOSTGRES_USER=postgresql\nPOSTGRES_PASSWORD=password\nPOSTGRES_DB=mydb\nJWT_SECRET=dGVzdFNlY3JldEtleU5vdEZvclByb2R1Y3Rpb24\nGEMINI_API_KEY=your_gemini_api_key\n```\n\n### 3. Build and Run the Application with Docker Compose: Linux and MacOS\n\nTo start the PostgreSQL database and Spring Boot backend services, run the following command:\n\n```shell\nsudo docker-compose up -d --build\n```\n\n### 3.1 Running the Application with Docker Compose: Windows\n\nBefore running the application you have to run this command to convert mvnw file to Unix format:\n\n```shell\ndos2unix mvnw\n```\n\nNow, you can run the application with the following command:\n\n```shell\ndocker-compose up -d --build\n```\n\n### 3.2 **If you need to start only the Database:** Linux, MacOS, and Windows\n\n```shell\nsudo docker-compose up -d db\n```\n\n### Optional. Running the Application Locally (Outside Docker)\n\nIf you want to run the backend outside of Docker (e.g., using IntelliJ IDEA), make sure to add the\n.env file variables to the IntelliJ IDEA Run/Debug Configuration.\n\n```shell\nPOSTGRES_DB=mydb;POSTGRES_PASSWORD=password;POSTGRES_USER=postgresql;JWT_SECRET=ZEdWemRGTmxZM0psZEV0bGVVNXZkRVp2Y2xCeWIyUjFZM1JwYjI0;GEMINI_API_KEY=your_gemini_api_key;GEMINI_API_SECRET=your_gemini_api_secret\n```\n\n### 5. Stopping the Application\n\nTo stop and remove all containers, use:\n\n```shell\nsudo docker-compose down\n```\n\n## Integration with Mobile App\n\n- The mobile app for this project is built with Flutter and can be found at the following\n  repository:\n  [Stepwise](https://github.com/elffirem/StepWise)\n\n- To integrate the backend with the mobile app, you need make sure that backend is running via\n  **docker compose** and then run the mobile app.\n- Now, you can read the instructions in the mobile app repository to set up the mobile\n  app: [README.md](https://github.com/elffirem/StepWise/blob/main/README.md)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbehzodfaiziev%2Fstepwise-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbehzodfaiziev%2Fstepwise-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbehzodfaiziev%2Fstepwise-backend/lists"}