Veld Framework

Ultra-fast Dependency Injection for Java - Zero Reflection, Pure Code Generation

Veld is a compile-time Dependency Injection framework that generates pure Java code. Zero reflection at runtime means maximum performance - up to 100x faster than Spring in dependency resolution benchmarks.

Designed for developers who want maximum performance, full control, and zero runtime magic.

Quick Start

1. Add Dependencies

Maven:

<dependency>
    <groupId>io.github.yasmramos</groupId>
    <artifactId>veld-runtime</artifactId>
    <version>1.0.3</version>
</dependency>
<dependency>
    <groupId>io.github.yasmramos</groupId>
    <artifactId>veld-annotations</artifactId>
    <version>1.0.3</version>
</dependency>

Gradle:

implementation 'io.github.yasmramos:veld-runtime:1.0.3'
implementation 'io.github.yasmramos:veld-annotations:1.0.3'

2. Configure Maven Plugin

<build>
    <plugins>
        <plugin>
            <groupId>io.github.yasmramos</groupId>
            <artifactId>veld-maven-plugin</artifactId>
            <version>1.0.3</version>
        </plugin>
    </plugins>
</build>

3. Create Components

import io.github.yasmramos.veld.annotation.Component;
import io.github.yasmramos.veld.annotation.Inject;

@Component
public class UserService {
    private final UserRepository repository;
    
    @Inject
    public UserService(UserRepository repository) {
        this.repository = repository;
    }
    
    public User getUser(Long id) {
        return repository.findById(id);
    }
}

4. Use Veld

import io.github.yasmramos.veld.Veld;

public class Main {
    public static void main(String[] args) {
        UserService userService = Veld.userService();
        User user = userService.getUser(1L);
    }
}

Why Veld?

| Feature | Veld | Spring | Guice | |---------|------|--------|-------| | Reflection at runtime | None | Heavy | Moderate | | Startup time | ~0.1ms | ~500ms+ | ~100ms | | Injection speed | ~0.001ms | ~0.01ms | ~0.005ms |

Performance Highlights

Up to 100x faster than Spring in dependency resolution benchmarks
3ns average injection latency
0.003ms startup time
Zero runtime reflection overhead

Documentation

| Topic | Location | |-------|----------| | Getting Started | docs/getting-started.md | | Annotations Reference | docs/annotations.md | | Core Features | docs/core-features.md | | API Reference | docs/api.md | | AOP Guide | docs/aop.md | | EventBus | docs/eventbus.md | | Performance Benchmarks | docs/benchmarks.md | | Architecture | docs/architecture.md | | Examples | docs/examples.md |

Modules

| Module | Description | |--------|-------------| | veld-annotations | Core annotations | | veld-runtime | Runtime utilities | | veld-processor | Annotation processor | | veld-weaver | Bytecode weaving | | veld-maven-plugin | Unified build plugin | | veld-aop | Aspect-Oriented Programming | | veld-resilience | Circuit Breaker, Retry, Rate Limiter | | veld-cache | Caching support | | veld-validation | Bean validation | | veld-security | Method-level security | | veld-metrics | Metrics collection | | veld-tx | Transaction management | | veld-spring-boot-starter | Spring Boot integration |

Spring Boot Starter

To integrate Veld with Spring Boot applications, use the Spring Boot starter.

Add Dependency