Lexicubes

Lexicubes is a Boggle-like word search game played on a set of isometric cubes. The frontend is written in TypeScript with React and Tailwind CSS. The backend is written in Java with Spring Boot and MySQL for the database.

Running the site locally

Getting started

Backend

1. Ensure that you have Gradle and Docker installed.

2. Open the project in Intellij IDEA and run the BackendApplication configuration. Alternatively, you can run the app via the command line using the Gradle wrapper:

   cd backend
   ./gradlew bootRun --args="--spring.profiles.active=dev"

   The backend should be running and visible at http://localhost:8080. The app should automatically spin up a Docker container with a MySQL database (for development purposes) and connect to the database without any extra configuration.

3. Some spring-cloud-gcp dependencies may fail on startup if credentials are not provided. You can provide credentials by installing the Google Cloud CLI and running:

   gcloud auth application-default login

   This will obtain your credentials via a web flow and put them in a location accessible to the app (see Application Default Credentials).

Frontend

1. Ensure that you have npm installed.

2. Install all dependencies:

   cd frontend
   npm install

3. Start the Vite development server:

   npm run dev

   The site should be visible at http://localhost:5173.