Getting Started

Prerequisites

Install:

  • Git with access to the private CloudSeed repository
  • Docker with Docker Compose
  • A current stable Rust toolchain
  • just, the recommended task runner

Node.js and npm are only required when compiling Tailwind CSS directly on the host.

Clone and configure

git clone git@github.com:HAMY-LABS/cloudseed-rs-base.git
cd cloudseed-rs-base
cp .env.example .env

The example environment is ready for the local PostgreSQL service. Replace the session secret before using the app outside local development.

Run the complete stack

just docker-up

Open http://localhost:5000. Docker Compose starts PostgreSQL and the application, and the application runs database migrations during startup.

Stop the stack with:

just docker-down

Run Rust on the host

Start PostgreSQL, compile the stylesheet, and run the app:

just db
cd styles
npm ci
npx @tailwindcss/cli -i tailwind.css -o ../static/css/tailwind.css
cd ..
just run

The generated stylesheet is not committed. Recompile it after changing Rust template classes or styles/tailwind.css.