# Soda > Soda (SodaJS, npm package @getsoda/core) is a class-based web framework for Bun: modules, dependency injection, controllers, guards, interceptors and exception filters written with standard TC39 decorators, compiled into Bun's native router. Requires Bun 1.4 or later. - Create a project: `bun create soda my-app`. Add to an existing one: `bun add @getsoda/core`. - Standard decorators: no `experimentalDecorators`, no `emitDecoratorMetadata`, no `reflect-metadata`. - Dependencies come from `inject()`. A route lists its arguments in its decorator: `@Get(':id', [param('id', int)])`. - Validation with any Standard Schema library (zod, valibot, arktype); OpenAPI is generated from the same schemas. - Entry points: `@getsoda/core`, `@getsoda/core/jwt`, `@getsoda/core/throttler`, `@getsoda/core/openapi`, `@getsoda/core/testing`. - Soda is 0.x: the API may change between minor versions. ## Getting started - [Getting started](https://sodajs.dev/docs/getting-started.md): Bun 1.4 or later. No TypeScript flags are needed: Soda uses standard decorators, not experimentalDecorators. ## Essentials - [Controllers](https://sodajs.dev/docs/controllers.md): A controller is a class whose methods serve routes. List it in the controllers of a module. - [Validation](https://sodajs.dev/docs/validation.md): Soda validates with any Standard Schema library: zod, valibot, arktype and others. No DTO classes, no class-validator: the schema is the type. - [Providers and modules](https://sodajs.dev/docs/providers-and-modules.md): A class gets its dependencies with inject(), in a field initializer or its constructor. - [Request pipeline](https://sodajs.dev/docs/request-pipeline.md): Guards, interceptors and filters are what Nest calls enhancers. They are declared globally, on a controller or on a method, and run in Nest's order: global… ## Features - [Configuration](https://sodajs.dev/docs/configuration.md): A configuration is a schema over the environment, validated when the application starts and injected with its type. - [Authentication](https://sodajs.dev/docs/authentication.md): @getsoda/core/jwt signs and verifies JSON Web Tokens with WebCrypto, without dependencies: HS256/384/512, RS, PS, ES and EdDSA; keys as secrets, PEM, JWK or… - [WebSockets](https://sodajs.dev/docs/websockets.md): A gateway serves WebSocket connections on a path, with Bun's native WebSockets and their pub/sub. List it in the controllers of a module, like a controller. - [Rate limiting](https://sodajs.dev/docs/rate-limiting.md): @getsoda/core/throttler limits how many requests each client sends to each route, as @nestjs/throttler does. - [OpenAPI](https://sodajs.dev/docs/openapi.md): @getsoda/core/openapi builds the document from your code: everything the routes already declare is described, with no decorator. - [CQRS](https://sodajs.dev/docs/cqrs.md): @getsoda/core/cqrs separates what changes the application (commands) from what reads it (queries), and lets modules react to what happened (events), as… - [Logging](https://sodajs.dev/docs/logging.md): The application has a Logger, injectable everywhere. By default a ConsoleLogger, which draws a summary of the application once it listens. ## Shipping - [Testing](https://sodajs.dev/docs/testing.md): Tests run with bun test. @getsoda/core/testing serves the application on a free port of localhost, with a silent logger, as Nest's Test.createTestingModule()… - [Production](https://sodajs.dev/docs/production.md): The bundle holds your code and its dependencies in one file. Running the sources with bun src/main.ts works too: Bun runs TypeScript as is, and the bundle… - [Checking and inspecting](https://sodajs.dev/docs/check.md): Two commands look at the application without starting it. ## Recipes - [Database](https://sodajs.dev/docs/recipes/database.md): Soda has no database module, and needs none: a client is a provider, opened at startup and closed with the application. - [File uploads](https://sodajs.dev/docs/recipes/file-uploads.md): form() reads multipart/form-data bodies; files are File objects, Bun's, with name, type, size and the content. ## From Nest - [From Nest](https://sodajs.dev/docs/from-nest.md): Soda keeps Nest's model (modules, providers, controllers, guards, interceptors, filters) and changes how it is written, because it uses standard decorators and… ## Optional - [All documentation in one file](https://sodajs.dev/llms-full.txt) - [HTTP benchmark](https://github.com/getsodajs/soda/tree/main/bench/http): Soda, Hono and Nest over HTTP - [Source code](https://github.com/getsodajs/soda)