🧭 Rikta

The Zero-Config TypeScript Framework for Modern Backends.

Build scalable APIs with the power of Fastify and the elegance of decorators. No modules. No boilerplate. Just code.

🤔 Why Rikta?

Do you miss the simplicity of Express but need the structure of a real framework?

Rikta is designed for developers who want to move fast without breaking things.

• 🚀 Zero-Config Autowiring: No imports: [], exports: [], or providers: [] arrays. Just decorate your class, and it works.
• ⚡ Fastify Powered: Built on top of Fastify for maximum performance and low overhead.
• 🛡️ Type-Safe by Default: Native Zod integration for validation that infers your TypeScript types automatically.
• 🔄 Hybrid Lifecycle: Powerful hooks and an event bus for complex application flows.

Rikta is nordic for "guide". Let Rikta guide you to build better backends, faster.

⚡ Quick Start

Get up and running in seconds with the Rikta CLI:

# Create a new project
npx @riktajs/cli new my-app

# Start development
cd my-app
npm run dev

That's it! 🎉 Your API is running at http://localhost:3000

What you get

The CLI generates a complete project with:

• ✅ TypeScript configuration optimized for Rikta
• ✅ Example controller with REST endpoints
• ✅ Example service with dependency injection
• ✅ Hot reload development server
• ✅ Production build for serverless deployment

Generated Code Example

// src/controllers/app.controller.ts
import { Controller, Get, Autowired } from '@riktajs/core';
import { GreetingService } from '../services/greeting.service.js';

@Controller()
export class AppController {
  @Autowired()
  private greetingService!: GreetingService;

  @Get('/')
  index() {
    return { message: this.greetingService.getGreeting() };
  }

  @Get('/health')
  health() {
    return { status: 'ok', timestamp: new Date().toISOString() };
  }
}

// src/services/greeting.service.ts
import { Injectable } from '@riktajs/core';

@Injectable()
export class GreetingService {
  getGreeting(): string {
    return 'Welcome to Rikta! 🚀';
  }
}

📦 Packages

Package	Description	Version
@riktajs/core	Core framework with DI, routing, and validation
@riktajs/cli	CLI for scaffolding and development
@riktajs/swagger	OpenAPI/Swagger documentation
@riktajs/typeorm	TypeORM integration
@riktajs/queue	BullMQ-based job queue integration for Rikta

🛠️ CLI Commands

# Global installation (optional)
npm install -g @riktajs/cli

# Or use npx directly
npx @riktajs/cli new my-app

See the CLI Guide for full documentation.

📚 Documentation

Everything you need to build production-ready APIs.

⚡ Performance

Rikta is built on Fastify and delivers excellent performance. From our benchmarks:

Rikta adds minimal overhead (~2-5%) over vanilla Fastify while providing DI, decorators, and structured architecture.

For detailed tests:

cd benchmarks
npm install
npm run bench

Production Mode

For maximum performance, use silent mode:

const app = await Rikta.create({
  port: 3000,
  silent: true,   // Disable all console output
  logger: false   // Disable Fastify logging
});

✨ Key Features

🚫 No Modules, Just Logic

Forget about AppModule, UserModule, SharedModule. Rikta scans your code and resolves dependencies automatically.

✅ Native Zod Validation

Don't duplicate your types. Define a Zod schema, and Rikta validates the request and gives you the TypeScript type.

@Post()
create(@Body(UserSchema) user: z.infer<typeof UserSchema>) {
  // If we get here, 'user' is valid and typed.
  // If not, Rikta returns a 400 Bad Request automatically.
}

🔌 Powerful Dependency Injection

Support for Singleton (default) and Transient scopes, factory providers, and value tokens.

@Injectable()
class AuthService {
  constructor(
    @Autowired(DB_CONFIG) private config: Config,
    @Autowired() private logger: LoggerService
  ) {}
}

💖 Sponsors

Rikta is proudly sponsored by:

Artiforge - AI-powered development tools

🤝 Contributing

We love contributions! Please check our Contributing Guide (Coming Soon) and join our community.

📄 License

Rikta is MIT licensed.