Project Settings
Configure your project's appearance, integrations, and languages.
Access Project Settings
- Open your project from the Projects page
- 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:
- Picking a theme in Theme
- Turning Passwordless sign-in on or off
- Uploading a Project Logo or a Firebase Service Account File
General
Customization
- Name: The display name for your project. It can't be empty.
- Project Logo: Upload a logo for your platform.
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:
| Color | Used for | Default |
|---|---|---|
| Main | Primary brand color | #EF6C00 |
| Secondary | Secondary color | #333333 |
| Alert | Warnings | #8C660B |
| Error | Errors | #CE2C2C |
| Success | Success messages | #247C2E |
| Background | Page background | #FFFFFF |
| Ink | Text | #333333 |
| Disabled | Disabled 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:
- Stripe Secret Key: Your Stripe secret key (starts with
sk_) - Stripe Public Key: Your Stripe publishable key (starts with
pk_)
Click Save to save the keys. For detailed setup instructions, see Stripe Setup.
Firebase
Configure authentication for your platform:
- Firebase API Key: Firebase Web API key
- Firebase Auth Domain: Authentication domain (e.g.,
your-project.firebaseapp.com) - Firebase Project ID: Your Firebase project identifier
- Firebase Storage Bucket: Storage bucket URL
- Firebase Messaging Sender ID: Cloud messaging sender ID
- Firebase App ID: Firebase application ID
- Firebase Measurement ID: Google Analytics measurement ID (optional)
- Firebase Service Account File: Upload your Firebase service account JSON file
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:
- Resend API Key: Your Resend API key
- Resend From Email: The email address that outgoing emails will be sent from
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:
- Turn off Use default Dockerized database
- Under Database Type, choose SQL (PostgreSQL, MySQL, Supabase...). Your platform connects to PostgreSQL only, so the database must be PostgreSQL.
- 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
- Optionally click Test Connection to verify your settings
- 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:
- Turn off Use default Dockerized database
- Under Database Type, choose Firebase Firestore
- Ensure your Firebase service account has the necessary Firestore permissions
- 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.