Droplets are integrations between third-party services and Fluid. This is a repository intended to be used as an example for creating Droplets.
Documentation can be found in the project's GitHub page
- Google Cloud Run (Web)
- Google Cloud Storage (Terraform)
- Google Cloud SQL (postgreSQL)
- Google Cloud Build (CI/CD)
- Google Cloud Compute Engine (jobs console)
- Artifact Registry (Docker)
web: Google Cloud Run name fluid-droplet-NAME
jobs console: Google Cloud Compute Engine name fluid-droplet-NAME-jobs-console
Run github action to deploy to google cloud deploy production
or run the following command to deploy to google cloud
gcloud beta builds submit --config cloudbuild-production.yml --region=us-west3 --substitutions=COMMIT_SHA=$(git rev-parse --short HEAD),_TIMESTAMP=$(date +%Y%m%d%H%M%S) --project=fluid-417204 .
Add environment variables to google cloud add-update-env-gcloud.sh and run the following command to add environment variables to google cloud
sh add-update-env-gcloud.sh
Install dependencies with bundle install and yarn install
and install foreman with gem install foreman
Just the rails server (port 3000)
foreman start -f Procfile.dev
Running everything (port 3200)
bin/dev
Configure your environment variables in .env file
and run the following command:
make install
Running it as a docker service (port 3600)
make up
Run make help to see all commands
MIT License
Copyright (c) 2025 Fluid Commerce
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.