Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tech.illasoft.com/llms.txt

Use this file to discover all available pages before exploring further.

​
技术栈

类别技术说明
框架Next.js 16 (App Router)SSR + React 19
语言TypeScript
样式Tailwind CSS 4实用优先
UI 组件shadcn/ui基于 Radix UI
状态管理Zustand（3 个 store）auth / feed / poisson
AI SDKVercel AI SDK v6SSE + tool calling
国际化next-intl12 locale
分析PostHog用户行为
监控Sentryclient / server / edge
认证Supabase AuthSSR session via lib/supabase/middleware.ts
数据获取TanStack Query47+ client hooks，6+ server fetchers
2D 渲染Pixi.js 8 + @pixi/react图片画布
视频播放video.jsGenerator / Feed
音频播放Howler.jsGenerator / Feed
Centrifugocentrifuge-jsvideo_status / audio_status 推送

​
三路并行媒体类型

2026-03+ 起，图片 / 视频 / 音频三者都升级为一等媒体类型。Generator 根据 currentSelectMediaType 切换： 
Generator
├─ image → PixiApplicationWrapper + image selectors
├─ video → CanvasVideoPlayer + video selectors (generate / edit / extend / trim / motion)
└─ audio → AudioPlayerCard + audio selectors (music / instrumental / addVocals / trim)
详见 Generator / Audio / Video。

​
项目结构

kira-web
app
(home)
auth
gallery
generator
rewind
setting
timeline
user
layout.tsx
globals.css
components
providers
ui
seo
hooks
lib
apis
store
types
models
i18n
messages
public
sentry.client.config.ts
sentry.server.config.ts
sentry.edge.config.ts
next.config.ts
目录路径澄清：store/ 在仓库根目录，不是 src/store/。CLAUDE.md 的旧描述与实际不符。

​
架构图

​
部署

  • 托管在 Fly.io
  • Docker 容器化
  • 环境变量配置:
    • NEXT_PUBLIC_API_URL - 后端 API 地址
    • NEXT_PUBLIC_POSTHOG_KEY - PostHog Key
    • NEXT_PUBLIC_SUPABASE_* - Supabase 配置
    • NEXT_PUBLIC_SENTRY_DSN - Sentry DSN

​
相关文档