{"id":18872039,"url":"https://github.com/calebabg/soarbeyond","last_synced_at":"2026-02-15T15:30:15.556Z","repository":{"id":37025845,"uuid":"429520246","full_name":"CalebABG/SoarBeyond","owner":"CalebABG","description":"A simple web app for reflecting and writing thoughts, emotions, and mindfulness!","archived":false,"fork":false,"pushed_at":"2023-04-15T21:57:28.000Z","size":2357,"stargazers_count":3,"open_issues_count":15,"forks_count":0,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2024-12-31T00:16:39.480Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CalebABG.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/Roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-18T17:28:47.000Z","updated_at":"2023-01-12T19:58:20.000Z","dependencies_parsed_at":"2024-11-08T05:29:40.794Z","dependency_job_id":"a6daa5c6-bf1c-442f-ab4f-98050ef27210","html_url":"https://github.com/CalebABG/SoarBeyond","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebABG%2FSoarBeyond","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebABG%2FSoarBeyond/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebABG%2FSoarBeyond/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebABG%2FSoarBeyond/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CalebABG","download_url":"https://codeload.github.com/CalebABG/SoarBeyond/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239824981,"owners_count":19703194,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-08T05:28:22.997Z","updated_at":"2026-02-15T15:30:15.501Z","avatar_url":"https://github.com/CalebABG.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](res/banner.png?raw=true \"SoarBeyond Logo\")\n\n# SoarBeyond\nKeeping a lot in your head, can be a lot! Soar beyond all of the stuff that drags you down. This is a work-in-progress Journaling web app with the goal of being a place to record and jot how you are feeling, how your day is or went, or whatever may be on your mind. Sometimes, just having a place to write can be helpful, and SoarBeyond aims to be that tool for you.\n\n---\n\n## Project Setup\n\n### **Resources**\n- [PostgreSQL](https://www.postgresql.org/)\n- [App Secrets](https://docs.microsoft.com/en-us/aspnet/core/security/app-secrets)\n\n\n---\n\n### **Preview**\n#### **Would definitely recommend installing [Visual Studio 2022 Preview!](https://visualstudio.microsoft.com/vs/preview/)**\n\n---\n\n\n### **Database**\nSoarBeyond uses [PostgreSQL](https://www.postgresql.org/) for its backend database store. So if you don't have PostgreSQL installed, make sure to install it before trying to run the solution.\n\n\n---\n\n\n### **Configuration / Secrets Management**\n- To manage storage of the `Database Connection String` and other important configuration/settings, the project makes use of an `appsettings.json` file.\n\n#### **Default**\n- When you clone the repo, before running the project, you'll need to edit the template `appsettings.json` file in the following directory: `src\\SoarBeyond.Web`\n\n1. For the **Database**, look for the `Persistence` section of the file, it will look something like this:\n   - ```json \n      \"Persistence\": {\n         \"Host\": \"localhost\",\n         \"Port\": \"5432\",\n         \"Database\": \"soarbeyond\",\n         \"Username\": \"postgres\",\n         \"Password\": \"\"\n      }\n     ```\n   - From there, just give the `Password` key a value (password for the Postgres user). You can of course change the `Username` key to be a different user in your PostgreSQL logins (just be sure to update the `Password` value to the changed login user's password).\n\n#### **App Secrets**\n- The alternative, and more recommended way (but still **NOT** suitable for `Production`) for managing the configuration file is using `User Secrets`\n\n- The advantage of using User Secrets, is that the file is stored in a separate location from the project tree. Because of this, those secrets aren't checked into source control.\n\n- The location of the `secrets.json` file is different between Operating Systems, but it's stored in a system-protected user profile folder on your computer.\n   - **Windows** \n     - `%APPDATA%\\Microsoft\\UserSecrets\\CalebABG-SoarBeyond\\secrets.json`\n   - **Mac / Linux** \n     - `~/.microsoft/usersecrets/CalebABG-SoarBeyond/secrets.json`\n\n1. In the `src\\SoarBeyond.Web` project, a `UserSecretsId` property is defined in the `src\\SoarBeyond.Web.csproj` file which looks like this:\n   - ```xml\n     \u003cUserSecretsId\u003eCalebABG-SoarBeyond\u003c/UserSecretsId\u003e\n     ```\n\n2. The structure for the file is the same for the [Default](#default) - `appsettings.json` approach\n   - Just copy what's in that template and paste it in the `secrets.json` file. Then fill in the needed pieces and you're good to go!\n\n---\n\n### Running the Project\n\n#### **Docker**\n- If you have `Docker` and `docker-compose` installed, then you can get up and running in **1** step!\n- Run the following command in the root folder\n   - ```\n     docker-compose -f \"docker-compose.yml\" up\n     ```\n- To stop the docker-compose containers, run this command:\n   - ```\n     docker-compose -f \"docker-compose.yml\" down\n     ``` \n\n\n#### **Getting Started**\n- If you're starting fresh, just cloned the repo, then you'll need to make sure you've done the needed [Configuration](#configuration--secrets-management), before running or debugging the solution.\n\n- If you're already using SoarBeyond, you may need to do any or all of the following to ensure that you have everything you need to run the latest and greatest!\n\n#### **Update your Database**\n1. If you have `dotnet ef` command line tools installed, you can run the following command in the root folder (`SoarBeyond`) to apply the latest migration.\n   - ```\n     dotnet ef database update --project src\\SoarBeyond.Data --startup-project src\\SoarBeyond.Web --verbose\n     ``` \n   - You can install the `dotnet ef` command line tool by following this document [Entity Framework Core Tools CLI](https://docs.microsoft.com/en-us/ef/core/cli/dotnet)\n\n2. If you're using Visual Studio, you can use the `Package Manager Console`. **Note**: Make sure in the tool window, to change the `Default project` to `src\\SoarBeyond.Data` , then execute the following command:\n   - ```\n     Update-Database\n     ``` \n   - You can install the `Package Manager Console` tools by following this document [Entity Framework Core Tools - Package Manager Console in Visual Studio](https://docs.microsoft.com/en-us/ef/core/cli/powershell)\n\n---\n\n## Issues? Features?? More???\n\nCreate an `issue` for the repo if you encounter any errors or strange behavior/functionality with the application. \n\n---\n\n## Closing Comments\nThank you for checking out this project. I hope it can provide even the smallest bit of help, in anyway for you! Please feel free to submit feature requests or suggestions for improvement!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalebabg%2Fsoarbeyond","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalebabg%2Fsoarbeyond","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalebabg%2Fsoarbeyond/lists"}