현재 Akan.js v1 문서를 보고 있습니다.최신 v2 문서 보기
사람함께에이전트▾
사람 — 직접 정하고 책임지는 비즈니스 규칙과 흐름. 직접 읽어보세요.
함께 — 개념은 알아두고, 세부 규칙은 에이전트가 따릅니다.
에이전트 — 에이전트가 따르는 규칙과 레퍼런스. 필요할 때 찾아보세요.
소개▾
튜토리얼▾
시스템 아키텍처▾
모듈 규칙▾
스칼라 규칙▾

시작하기

Akan.js는 실제 비즈니스를 코드로 설계하고 구현하는 것을 최우선으로 하는 풀스택 TypeScript 프레임워크입니다.
이를 위해 기술적인 부분들은 최대한 추상화되고, 개발자가 직접 구현하지 않아도 되도록 설계되었습니다.
최소한의 코드로 타입 안전한 서비스를 구축하고 웹, 모바일, 서버, DB인프라에 동시에 배포할 수 있습니다.

설치하기

Akan.js는 간단한 명령어로 설치할 수 있습니다. 설치 전 몇 가지 요구사항이 있습니다.
시스템 요구사항
Node.js 20.x 이상
pnpm 10.x 이상
Docker
Android Studio (Android 사용 시)
Xcode (iOS 사용 시)

새 프로젝트 생성

먼저 Akan.js CLI를 사용하여 새 프로젝트를 생성합니다. 프로젝트를 만들려면 다음 명령어를 실행하세요:
Terminal
입력 시 다음과 같은 프롬프트가 표시됩니다:
Terminal

개발 환경 실행

Terminal

실행하기

이제 Nextjs 클라이언트, React 클라이언트, 그리고 Nestjs Server를 사용할 수 있습니다.
클라이언트 제어
Next.js App Router 인터페이스로 페이지를 수정할 수 있습니다. 기본 페이지(/)를 수정하는 예시는 다음과 같습니다.
기본으로 생성된 템플릿을 수정하여 Hello Akan.js를 작성할 수 있습니다.
apps/<my-app>/app/[lang]/page.tsx
Next.js 페이지는 http://localhost:4200에서 확인할 수 있습니다. 서버사이드 렌더링 방식으로 작동되며, 웹 기반 운영에 최적화된 방식으로 작동합니다.
React 페이지는 http://localhost:4201에서 확인할 수 있습니다. 클라이언트사이드 렌더링 방식으로 작동되며, 모바일 앱 기반 운영에 최적화된 방식으로 작동합니다.
http://localhost:4200
Hello Akan.js! 🎉
서버 제어
main.ts 코드를 수정하여 Hello Akan.js 로깅을 작성해봅니다. Node.js 서버가 실행되는 엔트리 포인트 파일입니다.
apps/<my-app>/main.ts
Nest.js 서버가 실행되며 http://localhost:8080에서 작동합니다. 터미널에서 로그가 표시되는 것을 확인할 수 있습니다.
Terminal

MIT 라이선스 하에 배포되었습니다.

내 AI에 이 문서 연결하기

MCPhttps://akanjs.com/mcp
Copyright © 2026 Akan.js 모든 권리 보유.시스템 관리자bassman