Welcome to Cascarita! This file provides instructions on how to run important commands and navigate through the project.
Follow each part of pre-requisites to ensure a successful setup!
- Docker Desktop - used to run our client, server, and reverse proxy
- add ssh key to your GitHub - facilitates git version control
- DBeaver - open source database tool
- aws-cli - needed to fetch secrets to run our application
Each developer will have an AWS account needed for development. For more information, contact Armando or Luis to help you get setup!
- Log into your AWS account. The "Account ID" will be
cascarita
. The "IAM username" will be the first letter of your first name and your last name (i.e. "abanuelos"). For your first time logging in, your password will be temporary and then you will be given the option to change it! - Create an AWS access key. When you go through the flow of creating the access keys you will be given two values. Save them!:
AWS_ACCESS_KEY=
AWS_SECRET_ACCESS_KEY=
- Create a
.aws/credentials
and.aws/config
file at your root directory by running the following commands:
cd ~
mkdir .aws
touch .aws/credentials
touch .aws/config
- Modify the
.aws/config
file to look like the following:
[cascarita]
region=us-west-1
output=json
- Modify the
.aws/credentials
file with your AWS access and secret access key:
[cascarita]
aws_access_key_id=XXXXXXXX
aws_secret_access_key=XXXXXXXXXXXXXXXXXXX
We have a setup script that will:
- install necessary dependencies like
nvm
,node
,pnpm
,mysql
, etc. - pull environment variables from AWS Secrets Manager
- build and run Docker containers
make setup
After this is finished make sure to stop any local mysql
processes with:
brew services stop mysql
In order for us to have hot-reloads for frontend and backend changes with our docker containers, you need to grant Docker Desktop the following permissions by going to Docker Settings -> Resources -> File Sharing
and add the paths to your client
and server
directories.
make database
to run the latest migrationsmake restart
will restart the containers for effects to take effectmake build
to build new containers as neededmake test
will run backend related tests using jest
Copyright (c) 2025 Cascarita.io
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to use the Software for personal or academic purposes only, subject to the following conditions:
-
Non-Commercial Use Only: The Software may not be used, copied, modified, merged, published, distributed, sublicensed, or sold for commercial purposes or financial gain.
-
No Redistribution for Sale: The Software and its derivatives may not be sold, sublicensed, or otherwise distributed in exchange for any monetary or non-monetary compensation.
-
Ownership: The copyright holders retain all ownership and intellectual property rights of the Software. Any unauthorized use, duplication, or modification of the Software that violates this license will constitute a breach of copyright.
-
Attribution: The above copyright notice and this license must be included in all copies or substantial portions of the Software.
-
Warranty Disclaimer: 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.
By using this Software, you agree to the terms and conditions stated herein. If you do not agree, you may not use, modify, or distribute this Software.