Configuration
Config Parameters
Config Parameters enable dynamic runtime configuration management directly from Firestore. Leverage them to control feature flags, manage application settings, and store queryable values that drive your application's behavior.
Why Use Config Parameters?
While Firebase Remote Config provides valuable functionality, Dogen Config Parameters offer complementary capabilities through dedicated Firestore storage. Key advantages include:
- Complete type safety with schema validation
- Support for complex, nested data structures
- Native integration with your Firestore data model
- Unlimited parameters and fetch operations
Firebase Remote Config remains a powerful tool with unique strengths for client-side configuration. Depending on your requirements, you may choose to use Remote Config, Dogen Config Parameters, or both in tandem.
Common Use Cases
Feature Flags
Control feature availability in your application without deploying new code. Perfect for:
- A/B testing
- Gradual feature rollouts
- Beta program management
Application Settings
Manage application-wide settings that need to be easily updated:
- API endpoints
- Service configurations
- Global parameters
Complex Configurations
For more sophisticated needs, create structured configuration objects by leveraging Dogen's entity types. Your application can query these values from Firestore to control complex behaviors.
Your application can query these parameters directly from Firestore to enable dynamic behavior changes without redeployment.
For example, check if a feature flag is enabled before showing new functionality, or load service configurations at startup.
Creating Parameters
Start by creating a Config Parameter Blueprint in the Settings > Application > Parameter. You can make it as simple or complex as needed:
- Use simple types for basic flags and values
- Leverage Embedded Entities for reusable structured data
- Create Lists or Maps for collections of values
Managing Parameters
Once you've created your Config Parameters, you can manage them directly in the Config section, under the Parameters tab:
Here you can view and modify parameters. Clicking on the "LaunchDate" parameter lets us modify it:
Parameters can also take the form of Embedded Entitie and many other types.
Entity Configuration
Entity Configuration provides granular field-level control for Object and Embedded Entities, including Dogen's internal types. Configure default values, validation rules, and UI display settings for individual fields across your entity definitions.
Available Configurations
Default Values
Set initial values for fields when creating new entities.
Validation Rules
Define custom validation rules for each field to ensure data integrity.
Preview Settings
Configure UI options:
- Hide fields from preview
- Set colors, font options, and more.
Entity List Page Settings
Configure options:
- Set sort order
- Set items shown per page
Configuration changes should take effect immediately upon saving without requiring a generation. However, if you don't see your changes reflected try refreshing your browser window.
While most types do support configuration, some entities and types may not support it at this time. Stay tuned for updates on this feature.