https://github.com/fluojs/fluo
Standard-First TypeScript Backend Framework
https://github.com/fluojs/fluo
backend-framework bun cloudflare-workers deno dependency-injection nodejs standard-decorators typescript
Last synced: 6 days ago
JSON representation
Standard-First TypeScript Backend Framework
- Host: GitHub
- URL: https://github.com/fluojs/fluo
- Owner: fluojs
- License: mit
- Created: 2026-03-11T08:16:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-11T14:16:24.000Z (8 days ago)
- Last Synced: 2026-06-11T14:22:01.767Z (8 days ago)
- Topics: backend-framework, bun, cloudflare-workers, deno, dependency-injection, nodejs, standard-decorators, typescript
- Language: TypeScript
- Homepage: https://github.com/fluojs/fluo/tree/main/docs
- Size: 14.6 MB
- Stars: 19
- Watchers: 0
- Forks: 0
- Open Issues: 21
-
Metadata Files:
- Readme: README.ko.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.ko.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.ko.md
- Support: SUPPORT.ko.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
> **fluo**는 **TC39 표준 데코레이터**를 기반으로 처음부터 다시 설계된 현대적인 TypeScript 백엔드 프레임워크입니다. 레거시 데코레이터 기반 프레임워크에 대한 고성능, 명시적, 그리고 메타데이터가 필요 없는 대안을 제공합니다.
## 왜 fluo인가요?
NestJS와 같은 대부분의 TypeScript 프레임워크는 JavaScript 언어의 발전 방향과 동떨어진 `experimentalDecorators` 및 `emitDecoratorMetadata` 플래그에 의존하는 과거에 머물러 있습니다. fluo는 기술 생태계를 미래로 이끕니다.
- **🚀 마법 없는 고성능**: 무거운 리플렉션 라이브러리나 숨겨진 메타데이터 생성이 없습니다. fluo는 가볍고 빠르며, 하드웨어에 가까운 성능을 유지합니다.
- **🛡️ 암묵적 대신 명시적**: 의존성 주입(DI)이 투명하고 감사 가능합니다. 컴파일러가 생성한 불투명한 블롭이 아니라, 코드에서 직접 의존성 그래프를 확인할 수 있습니다.
- **🌍 어디서나 실행**: 통합된 런타임 파사드(Facade)를 기반으로 구축되었습니다. 로직 변경 없이 Node.js의 Fastify에서 Bun, Deno, 또는 Cloudflare Workers로 전환하세요.
- **✨ 미래 지향적**: 현대적인 TypeScript 시대를 위해 설계되었습니다. 레거시 컴파일러 동작과 싸우지 않고 가장 강력한 타입 안정성 기능을 활용하세요.
## 개발자 경험
조직화 능력은 NestJS처럼 강력하면서도, 명시성은 Go 언어처럼 느껴지는 프레임워크를 상상해 보세요.
```ts
import { Module, Inject } from '@fluojs/core';
import { UsersRepository } from './users.repository';
@Inject(UsersRepository)
export class UsersService {
constructor(private readonly repo: UsersRepository) {}
}
@Module({
providers: [UsersService, UsersRepository],
})
export class UsersModule {}
```
*레거시 플래그가 필요 없습니다. 오직 표준 TypeScript만 사용합니다.*
## 빠른 시작
CLI를 사용하는 것이 fluo를 경험하는 가장 빠른 방법입니다.
```bash
# CLI 설치
pnpm add -g @fluojs/cli
# 프로젝트 생성
fluo new my-backend
cd my-backend
# 엔진 가동
pnpm dev
```
생성된 Node.js 스타터 lifecycle script는 `fluo dev`, `fluo build`, `fluo start`로 위임하므로, CLI가 런타임별 명령을 선택하고 `NODE_ENV`가 없으면 적절한 기본값을 사용합니다. Bun, Deno, Cloudflare Workers 스타터는 같은 `fluo dev` 추상성을 유지하면서 runtime-owned watch loop를 기본값으로 사용하고, CLI restart supervisor가 필요하면 `fluo dev --runner fluo`를 제공하며, production 또는 deployment script는 각 런타임의 native 명령을 사용합니다.
생성된 스타터 템플릿에는 바로 프로덕션에 투입 가능한 Fastify 설정, 내장된 헬스 체크, 그리고 확장이 용이한 디렉터리 구조가 포함되어 있습니다.
## 모듈형 생태계
fluo는 거대한 단일체(Monolith)가 아닙니다. 정교하게 설계된 모듈들의 집합입니다.
| 카테고리 | 패키지 |
| :--- | :--- |
| **런타임** | [Fastify](./packages/platform-fastify), [Node.js](./packages/platform-nodejs), [Bun](./packages/platform-bun), [Deno](./packages/platform-deno), [Workers](./packages/platform-cloudflare-workers) |
| **데이터베이스** | [Prisma](./packages/prisma), [Drizzle](./packages/drizzle), [Mongoose](./packages/mongoose) |
| **API/통신** | [HTTP](./packages/http), [GraphQL](./packages/graphql), [OpenAPI](./packages/openapi), [WebSockets](./packages/websockets), [Socket.IO](./packages/socket.io) |
| **로직** | [DI](./packages/di), [CQRS](./packages/cqrs), [Validation](./packages/validation), [Serialization](./packages/serialization), [Config](./packages/config), [I18n](./packages/i18n) |
| **메시징** | [Notifications](./packages/notifications), [Email](./packages/email), [Slack](./packages/slack), [Discord](./packages/discord) |
| **운영** | [Metrics](./packages/metrics), [Health (Terminus)](./packages/terminus), [Redis](./packages/redis), [Queue](./packages/queue) |
## 이어서 읽기
- 📖 **[문서 포털](./book/README.ko.md)**: 아키텍처, DI, 패턴에 대한 심층 문서.
- 🚀 **[시작하기](./book/beginner/ch02-cli-setup.ko.md)**: fluo와 함께하는 첫 15분.
- 🧭 **[Canonical Runtime Package Matrix](./docs/reference/package-surface.ko.md)**: 공식 런타임/패키지 범위를 보여주는 기준 문서.
- 💡 **[예제 앱](./examples/README.ko.md)**: 최소 설정부터 복잡한 RealWorld API까지.
- 🛠️ **[CLI 가이드](./packages/cli/README.ko.md)**: 신속한 개발을 위한 `fluo` 명령어 마스터하기.
## 커뮤니티
- 💬 **[Discussions](https://github.com/fluojs/fluo/discussions)**: 질문, 아이디어, RFC, 쇼케이스 공유.
- 🐛 **[Issues](https://github.com/fluojs/fluo/issues)**: 버그 제보, 문서 개선 제안, 기능 요청.
- 🤝 **[기여 가이드](./CONTRIBUTING.md)**: 로컬 개발 환경, 검증 절차, PR 흐름.
- 🛟 **[지원 안내](./SUPPORT.md)**: 용도에 맞는 지원 채널 안내.
- 🔒 **[보안 정책](./SECURITY.md)**: 비공개 취약점 제보 정책.
## 우리의 철학
우리는 **동작 계약(Behavioral Contracts)**의 힘을 믿습니다. 이 저장소의 모든 패키지는 엄격한 안정성 규칙을 따르며, 사용 중인 런타임에 관계없이 백엔드가 예상한 대로 정확하게 동작하도록 보장합니다.
- [릴리스 거버넌스](./docs/contracts/release-governance.ko.md)
- [동작 계약 정책](./docs/contracts/behavioral-contract-policy.ko.md)
- [기여하기](./CONTRIBUTING.ko.md)
- [지원 안내](./SUPPORT.ko.md)
- [보안 정책](./SECURITY.ko.md)
---
TypeScript 커뮤니티를 위해 ❤️로 만들었습니다.
