Project Settings

Configure your project's appearance, integrations, and languages.

Access Project Settings

  1. Open your project from the Projects page
  2. Click on Settings in the project navigation menu

The Project Settings page has three tabs: General, Integrations, and Internationalization. Each tab is divided into sections you can expand.

How Changes Are Saved

There is no single save button for the whole page. Customization, Colors, Stripe, Firebase, Resend, and Database each have their own Save button, which saves only that section. A Settings saved message confirms it.

These settings save as soon as you change them, without Save:

General

Customization

Click Save to save the name.

Theme

The list shows your project's current theme, the themes it recently used in this browser, and the Default theme. Pick a theme to apply it right away. View in catalog opens that theme's page, and Browse themes… opens the theme catalog. When a newer version of your current theme is available, the section tells you so; click Upgrade to switch to it.

For more details, see Using a Theme.

Colors

Customize your platform's color scheme:

ColorUsed forDefault
MainPrimary brand color#EF6C00
SecondarySecondary color#333333
AlertWarnings#8C660B
ErrorErrors#CE2C2C
SuccessSuccess messages#247C2E
BackgroundPage background#FFFFFF
InkText#333333
DisabledDisabled elements#9CA3AF

Enter each color as a 6-digit hex value, such as #3B82F6. Any other format, including CSS color names and 3-digit hex values like #FFF, is replaced by the default color in your bundle.

Click Save to save the colors.

Integrations

Stripe

Configure payment processing for subscriptions:

Click Save to save the keys. For detailed setup instructions, see Stripe Setup.

Firebase

Configure authentication for your platform:

Upload the service account file before you click Save. Once you fill in the Firebase settings, saving requires the Firebase API Key, Firebase Auth Domain, Firebase Project ID, and an uploaded service account, and DevOur checks them against your Firebase project.

Below the Save button, the Passwordless sign-in switch lets people sign in to your platform with a link sent to their email. See Firebase Setup for how to turn it on, and for detailed Firebase setup instructions.

Resend

Configure email delivery for your platform:

Click Save to save the settings. For detailed setup instructions, see Resend Setup.

Database

Choose where your platform stores its data. For step-by-step instructions, see Database Setup.

Default Database

With Use default Dockerized database turned on, which is the default, your bundle includes a PostgreSQL database that runs in its own Docker container next to your platform. It requires no configuration.

Custom SQL Database

To use your own PostgreSQL database:

  1. Turn off Use default Dockerized database
  2. Under Database Type, choose SQL (PostgreSQL, MySQL, Supabase...). Your platform connects to PostgreSQL only, so the database must be PostgreSQL.
  3. Configure your database connection:
    • Host: Database server hostname or IP address
    • Port: Database port (default: 5432)
    • User: Database username
    • Database Name: Database name
    • Password: Database password
  4. Optionally click Test Connection to verify your settings
  5. Click Save

Your platform connects to this database over SSL, so the database must accept SSL connections.

If your database isn't reachable from the internet, check Do not test connection to the database. I know what I am doing, my database is not externally reachable. It disables Test Connection and lets you save without filling in Host, User, and Database Name.

Firestore

To use Firebase Firestore:

  1. Turn off Use default Dockerized database
  2. Under Database Type, choose Firebase Firestore
  3. Ensure your Firebase service account has the necessary Firestore permissions
  4. Click Save, then Test Firebase Configuration to check your saved Firebase settings and service account

Internationalization

Locales

The Locales section is on the Internationalization tab. Translate your platform's interface into the languages your users speak. See Locales & Translations.

From the CLI

You can apply these settings without opening the web app. Put them in your configuration file and run devour setup --config devour.json, or change a single setting with devour setup --key colorMain --value "#3B82F6". The configuration file covers the name, theme, logo, colors, Stripe, Firebase and Resend keys, the Firebase service account, passwordless sign-in, and the database settings.

Use default Dockerized database and the checkbox that skips the connection test can only be changed in the web app.

For every available key, see the CLI Reference.