Tinder 式滑动信息流,右滑评分、左滑跳过,已看卡片自动移除
social-media-app-template — React 排行榜模板
作者 SurefireStudios
基于 Bun、Express、PostgreSQL 与 React 的全栈社交应用模板,内置滑动信息流、私信、通知、排行榜与后台管理。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 2
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
服务端会话认证,httpOnly cookie 加 argon2id 哈希,客户端不传用户 ID
内置关注、评论、举报、私信、通知与积分排行榜
管理后台支持封禁、删帖、处理举报、管理广告和广播公告
66 项 HTTP 冒烟测试覆盖访问控制与密码哈希泄漏
前后端共享 Drizzle schema 与 zod 类型,改字段后 TypeScript 会指出所有待更新位置
模板详细介绍
这是一个可直接运行的全栈社交应用模板,核心是 Tinder 式滑动信息流:右滑评分、左滑跳过,已看过的卡片不再出现。围绕它配套了账号体系、个人资料、关注、评论、一对一私信、通知、积分排行榜(全局或仅关注的人)以及管理后台,还留了一个广告位。技术栈为 Bun、Express 4、PostgreSQL、Drizzle ORM、React 18、Vite 5、Tailwind、Radix UI、TanStack Query 和 wouter,前后端共享 TypeScript 类型。API 与构建后的客户端由同一进程提供,适合部署在单个免费层 Web 服务上。
认证部分值得单独看:登录后只设置一个 httpOnly 签名会话 cookie,服务端通过会话识别用户,客户端不传递用户 ID,也没有 localStorage 令牌。server/auth.ts 提供 requireAuth、requireAdmin、requireSelf 和 optionalUserId 四个中间件,其中 requireSelf 用于带用户 ID 的路由,防止改 URL 读他人数据。密码用 Bun.password 的 argon2id 哈希,响应中间件会剥离 passwordHash。仓库自带 66 项 HTTP 冒烟测试,覆盖公开路由、越权访问和密码泄漏等场景。
需要留意的是,模板明确说明它只是起点而非完成的安全方案:认证路由没有限流,缺少邮箱验证和密码重置,上传图片写在本地磁盘,在 Render、Fly 等临时文件系统上重启即丢失,需自行迁移到对象存储。隐私政策和服务条款页面是占位内容,上线前必须替换。种子密码明文写在 server/seed.ts 中,只应种入可丢弃的数据库。
适合你的项目吗?
适用场景
- 想快速搭建带滑动交互的社交产品原型,直接 fork 后替换业务主题
- 需要一套可参考的服务端会话认证与路由守卫实现
- 用于教学或内部演示,展示全栈 TypeScript 应用的结构
- 作为需要排行榜、私信和后台管理的社区类应用起点
适合人群
- 熟悉 TypeScript、React 和 Express,能自行调整 schema 与路由的开发者
- 接受 Bun 1.2+ 与 PostgreSQL 作为运行环境,并愿意自行处理部署细节的团队
- 需要可点击、可演示的完整应用而非空脚手架的项目
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
需要 Bun 1.2 或更新版本,以及任意 PostgreSQL 数据库(本地或 Neon 免费实例)
- 2
复制 .env.example 为 .env,填入 DATABASE_URL 和至少 32 字符的 SESSION_SECRET,否则服务拒绝启动
- 3
依次运行 bun run db:push、bun run db:seed、bun run dev,默认端口 5000
- 4
种子数据包含六个账号,共用密码 demo1234,第一个为管理员;该密码明文写在 server/seed.ts
- 5
上传图片默认写入本地磁盘,临时文件系统上会丢失,上线前需迁移到 S3、R2 或 Cloudinary
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可,可免费使用、修改、商用甚至出售;README明确仅要求保留许可证中的署名。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明与许可声明
额外费用与待核对事项
- 上传图片写入本地磁盘,临时文件系统上会丢失,非授权限制
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
Fork it, rename it, ship it, sell it — attribution in the licence text is all that is asked.
README 原文
https://github.com/SurefireStudios/social-media-app-template/blob/main/LICENSEhttps://github.com/SurefireStudios/social-media-app-template/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 70 / 100
- 技术栈
- React
- 网站类型
- 排行榜 · 后台 · 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-09-11
- 截图检查日期
- 2026-09-13
目前没有记录演示链接。请依据仓库说明在本地评估;仅凭截图无法确认交互行为。
目录记录的主要技术栈是 React。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。
ant-design-pro
Ant Design Pro 是 Ant Design 官方推出的企业级中后台前端脚手架,基于 React 19、Umi Max 4 和 antd 6 构建,内置 TypeScript 支持。
React · 后台

react-boilerplate
react-boilerplate 是一个为有一定 React 和 Redux 经验的开发者设计的启动器,目标是快速搭建可扩展、离线优先的 Web 应用。
React · 启动器

coreui-free-react-admin-template
Free React Admin & Dashboard Template Built for AI-Assisted Development
React · 后台

fastapi-react
fastapi-react 是一个基于 Cookiecutter 的模板,用于快速搭建 FastAPI 与 React(TypeScript)的全栈项目。
React · 后台

react-antd-admin-template
一个基于React+Antd的后台管理模版,在线预览https://nlrx-wjc.github.io/react-antd-admin-template/
React · 后台

shadcn-landing-page
Free Landing page template using Shadcn, React, Typescript and Tailwind
React · 企业官网
