Repository navigation
Quickstart
https://github.com/new?template_name=ScottyStack&template_owner=scottylabs-labrador
The demo branch includes more example code used by https://stack.scottylabs.org.
You would want to rename all instances of "ScottyStack" to your preferred project
name. Using the "Match Case" option provides granular control: replace ScottyStack with the public‑facing project name and scottystack
with the codebase name. You would also want to exclude *.md files to prevent links within them from breaking.
Prerequisites: Docker and Dev Containers Extension.
-
Clone and open the repository locally in VS Code (or any other IDE that supports Dev Containers).
-
Click on the
Reopen in Containerbutton that pops up in the bottom left corner of the VS Code window.- Or open the command palette and run the command
Dev Containers: Reopen in Container.
- Or open the command palette and run the command
-
Wait for the container to start. It may take a few minutes to install dependencies and run post create script.
-
Install recommended extensions. You can view them by opening the command palette and run the command
Extensions: Show Recommended Extensions. -
Visit the README files in the corresponding folder to start developing!
Check if the Docker Desktop version is up to date.
If you see "port in use" error, use lsof -i :<PORT> to find the process using that port and kill it with kill -9 <PID>.
The dev container using Docker should mostly work on Windows, but we will add more tips here as we gather more data from Windows setups.
If the post create command in dev container fails, you can manually run the post create script in the container by running the following command in the root directory:
./.devcontainer/post-create.shPrerequisites: Docker and Homebrew.
Replace step 4 and 5 in Dev Container Setup with:
-
docker compose -f .devcontainer/docker-compose.yml up -d- Environment variables such as DATABASE_URL needs to be changed.
- E.g.
DATABASE_URL="postgresql://postgres:donotuseinprod@localhost:5432/scottystack"
- E.g.
- Environment variables such as DATABASE_URL needs to be changed.
-
Run
.devcontainer/post-create.sh