Contributing

Install uv

git clone ..
uv venv .venv --python 3.12
source .venv/bin/activate
uv sync --all-extras
pre-commit install --hook-type pre-commit --hook-type pre-push

Tailwind CSS

This project uses django-tailwind to manage CSS. CSS sources are located in the country_workspace/workspaces/theme/static_src/src/. If you need to edit the CSS follow the below steps:

Install node dependencies
```
./manage.py tailwind install
```

Configure the enviroment

export EXTRA_APPS="country_workspace.contrib.hope,django_browser_reload"
export EXTRA_MIDDLEWARES="django_browser_reload.middleware.BrowserReloadMiddleware,"

Build the final CSS

./manage.py tailwind build

Or you can run the development mode

./manage.py tailwind start

Run tests

pytests tests

Run Selenium tests (ONLY)

pytests tests -m selenium

Run Selenium any tests

pytests tests --selenium

Note

You can disable selenium headless mode (show the browser activity on the screen) using --show-browser flag

Run local server

./manage.py runserver

Note

To facililate developing you can use:

export AUTHENTICATION_BACKENDS="country_workspace.security.backends.AnyUserAuthBackend"

It works only if DEBUG=True

Docker compose

Alternatively you can use provided docker compose for development

docker compose up

Alternatively you can use provided docker compose for development

docker compose up