{"id":22816527,"url":"https://github.com/robertdluigi/cloudvault","last_synced_at":"2025-06-28T07:34:24.510Z","repository":{"id":267147119,"uuid":"900380680","full_name":"robertdluigi/cloudvault","owner":"robertdluigi","description":"Cloud storage solution","archived":false,"fork":false,"pushed_at":"2024-12-18T11:53:20.000Z","size":1371,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T22:42:11.142Z","etag":null,"topics":["cloud","file-sharing-application","storage"],"latest_commit_sha":null,"homepage":"","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/robertdluigi.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-12-08T16:24:40.000Z","updated_at":"2024-12-18T11:53:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"3449bd05-2629-4e03-93c7-d78d35b9a302","html_url":"https://github.com/robertdluigi/cloudvault","commit_stats":null,"previous_names":["robertdluigi/cloudvault"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/robertdluigi/cloudvault","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdluigi%2Fcloudvault","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdluigi%2Fcloudvault/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdluigi%2Fcloudvault/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdluigi%2Fcloudvault/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robertdluigi","download_url":"https://codeload.github.com/robertdluigi/cloudvault/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdluigi%2Fcloudvault/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262392860,"owners_count":23304002,"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":["cloud","file-sharing-application","storage"],"created_at":"2024-12-12T14:07:48.551Z","updated_at":"2025-06-28T07:34:24.504Z","avatar_url":"https://github.com/robertdluigi.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CloudVault\n\nCloudVault is a secure cloud storage solution that allows users to upload, store, and share files with ease.\n\nThis project was built to help me learn Golang and enhance my backend development skills.\n\n---\n\n## Tech Stack\n\n- **Frontend:** React, Next.js, TailwindCSS, Shadcn UI  \n- **Backend:** Golang (1.22), GraphQL  \n- **Database:** PostgreSQL 17 @ NeonDB (using GORM)  \n\n---\n\n## Features\n\n- **User Authentication**: Secure login and signup with JWT.  \n- **File Upload \u0026 Storage**: Upload and store files in the cloud.  \n- **File Sharing**: Share files easily with others via secure links.  \n- **Responsive UI**: Clean, modern, and responsive user interface.  \n\n---\n\n## Prerequisites\n\nBefore setting up the app, ensure you have the following installed:\n\n1. **Docker** (to build and run the application)  \n2. **kubectl** (for Kubernetes management, if deploying to a cluster)  \n3. **IBM Cloud CLI** (for managing IBM Kubernetes cluster)  \n4. **Node.js** (latest version, compatible with Next.js)  \n5. **Golang 1.22**  \n\n---\n\n## Setup Instructions\n\nFollow the steps below to set up CloudVault locally or on a Kubernetes cluster:\n\n---\n\n### Local Setup\n\n#### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/robertdluigi/cloudvault.git\ncd cloudvault\n```\n\n### 2. Backend Setup\n\n#### 1. Navigate to the backend directory\n\n```bash\ncd backend\n```\n\n#### 2. Create a .env file to store environment variables. Use the .env.example as reference\n\n```bash\ncp .env.example .env\n```\n\n#### 3. Update the .env file with your PostgreSQL connection string, JWT SECRET and other settings\n\n#### 4. Run the backend locally\n\n```bash\ngo mod tidy\ngo run server.go\n```\n\nThe backend will be available at http://localhost:8080\n\n### 3. Frontend Setup\n\n#### 1. Navigate to the frontend directory\n\n```bash\ncd frontend\n```\n\n#### 2. Instal dependencies\n\n```bash\nnpm install\n```\n\n#### 3. Run the frontend\n\n```bash\nnpm run dev\n```\nThe frontend will be available at http://localhost:3000\n\n## Docker Setup\n\nTo containerize and rup the app using Docker\n\n### 1. Build Docker Images\n\n**Backend:**\n\n```bash\ndocker build -t cloudvault-backend ./backend\n```\n\n**Frontend:**\n\n```bash\ndocker build -t cloudvault-frontend ./frontend\n```\n\n### 2. Run Docker Containers\n\n```bash\ndocker network create cloudvault-network\n\ndocker run -d --name cloudvault-backend --network cloudvault-network -o 8080:8080 cloudvault-backend\n\ndocker run -d --name cloudvault-frontend --network cloudvault-network -o 3000:3000 cloudvault-frontend\n```\n\nAccess the app at http://localhost:3000\n\n## Kubernetes Deployment (IBM Cloud)\n\n### 1. Kubernetes Cluster\n\n#### 1. Login to IBM Cloud\n\n```bash\nibmcloud login\n```\n\n#### 2. Create a free-tier Kubernetes cluster\n\n```bash\nibmcloud ks create cluster free --name cloudvault-cluster --zone \u003czone-name\u003e\n```\n\n#### 3. Configure kubectl for the cluster\n\n```bash\nibmcloud ks config --cluster cloudvault-cluster\n```\n\n### 2. Apply Kubernetes Resources\n\n#### 1. Build Docker Images and push them to a container registry (e.g. Docker Hub or IBM Container Registry):\n\n```bash\ndocker tag cloudvault-backend \u003cyour-registry\u003e/cloudvault-backend:latest\ndocker push \u003cyour registry\u003e/cloudvault-backend:latest\n\ndocker tag cloudvault-frontend \u003cyour-registry\u003e/cloudvault-frontend:latest\ndocker push \u003cyour registry\u003e/cloudvault-frontend:latest\n```\n\n#### 2. Deploy the backend and frontend to Kubernetes using the provided manifests\n\n*Before running this, open the files and edit the registry name and the environment variables*\n\n```bash\nkubectl apply -f k8s/backend=deployment.yml\nkubectl apply -f k8s/backend-service.yml\n\nkubectl apply -f k8s/frontend-deployment.yml\nkubectl apply -f k8s/frontend-service.yml\n```\n\n\n#### 3. Verify the deployments\n\n```bash\nkubectl get pods\nkubectl get svc\n```\n\n#### 4. Access the app via the EXTERNAL-IP or YOUR-DOMAIN provided by the frontend service\n\n```bash\nhttp://\u003cEXTERNAL-IP\u003e\n```\n\n```bash\nhttp://\u003cYOUR-DOMAIN\u003e\n```\n\n## Future Improvements\n\n- **Third-Party Cloud Storage**\n- **User activity and file usage**\n- **Real-time collaboration on shared files**\n- **File Encryption**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertdluigi%2Fcloudvault","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobertdluigi%2Fcloudvault","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertdluigi%2Fcloudvault/lists"}