How To: Set up wq with GitHub Codespaces
This is the recomended setup for new users because it doesn’t require any software packages to be installed on your local computer. However, note that GitHub Codespaces is a commercial product with a limited number of free hours. If you would like a fully local development environment, follow the Docker Desktop instructions instead.
Set up Codespace
Click “Use this template” -> “Create a new repository”
Specify a repository name, description, and access settings
Within the new repository, select “Code” -> “Codespaces” -> “Create codespace on main”
Wait a few minutes for the container to build.
Once the container is built, it will load much faster next time you open the project.
Start Dev Servers
- Within the Codespace, locate the Terminal…
… and enter the following commands:
db/manage.py migrate db/manage.py createsuperuser
When prompted, enter throwaway credentials since this is a dev instance.
Activate the “Run Debug Servers” command from the Run and Debug tab (or by pressing F5)
- Click on the link to open the application running on port 5173
Note: You can ignore the error saying “Can’t launch a browser in debug mode”. That said, you may want to open the codespace in Visual Studio Code for a better debugging experience (see below). Also, there will be a prompt for a second application start up on port 8000. That is the Django backend, which you won’t usually need to interact with directly during development (since the included Vite configuration proxies API requests to Django).
- Confirm that you can log into the application using the credentials you entered in step 6. If the screen is blank, try refreshing after Django comes up on port 8000.
Optional: Open in Visual Studio Code
For a better development experience, you can connect to the codespace from Visual Studio Code.
- Install Visual Studio Code
- At https://github.com/codespaces, locate your existing codespace and stop it if it is still running.
This step is necessary in order to prevent port forwarding issues when you connect to the codespace from your local machine.
- Select “Open in Visual Studio Code” from the same menu.
- You should now able to run the debug browser, and connect to ports in the codespace (including PostgreSQL) as if it was running on your local machine.
You now have a working wq development environment running in the cloud! At this point you can take any of the following steps: