Configuration Guide

Quickfall provides powerful configuration options to customize your development environment and optimize your applications.

Project Configuration

Configure your project settings, dependencies, and build options through the compact.config.yml file.

Runtime Settings

Fine-tune runtime behavior, memory management, and performance optimizations.

Project Configuration File

The compact.config.yml file is the heart of your project configuration:

# Project Configuration
name: my-quickfall-app
version: 1.0.0

# Build settings
build:
  target: native

# Dependencies
dependencies:
    http:
        lockref: "compact://http/2.51.0"

# Runtime configuration
runtime:
  memory_limit: 1GB
  worker_threads: 4
  gc:
    strategy: generational
    interval: 5000

Compact Lock File

The compact.dependencies.lock file is used to manage your project's dependencies. It ensures that the same version of each dependency is used across all machines, preventing discrepancies and ensuring consistency.

The lock file is automatically generated when you run compact install and should not be modified manually.

Advanced Settings

Compiler Options

The compiler section allows you to fine-tune the compilation process. Here are some common options:

compiler:
  optimization_level: 3
  target_arch: x86_64
  debug_symbols: true
  link_time_optimization: true

Best Practices

  • Keep sensitive information in environment variables
  • Use version control for configuration files
  • Document custom configuration options
  • Regularly review and update dependencies