douyin README

The project's README from github.com/zyronon/douyin. As one markdown file: README.md.

Douyin-Vue

English | Spanish | German | French | 简体中文 | 日本語

License Featured|HelloGitHub

Douyin | Trendshift

douyin-vue 是一个模仿 抖音|TikTok 的移动端短视频项目。Vue 在移动端的"最佳实践",媲美原生 App 丝滑流畅的使用体验。使用了最新的 Vue 技术栈,基于 Vue3、Vite5 、Pinia实现。数据保存在项目本地,通过 axios-mock-adapter 库拦截Api 并返回本地json数据,模拟真实后端请求

在线访问

Github Pages: https://dy.typewords.cc/

链接

【模仿抖音系列】一:200行代码实现类似Swiper.js的轮播组件
【模仿抖音系列】二:实现抖音 “视频无限滑动“效果
【模仿抖音系列】三:Vue 路由使用介绍以及添加转场动画
【模仿抖音系列】四:Vue 有条件路由缓存,就像传统新闻网站一样
【模仿抖音系列】五:Github Actions 部署 Pages、同步到 Gitee、翻译 README 、 打包 docker 镜像
【模仿抖音系列】六:使用rem、动态vh自适应移动端

运行

注意:本项目仅适用于学习和研究,不得用于商业使用

快速部署至 Vercel

Deploy with Vercel

部署到 Docker

# pull Docker image
docker pull ghcr.io/zyronon/douyin-vue:latest

# start container, nginx reverse proxy custom port, for example: docker run -d -p 80:80 ghcr.io/zyronon/douyin-vue:latest
docker run -d -p 80:80 ghcr.io/zyronon/douyin-vue:latest

本地开发

注意:必须 git 命令 clone 下来才能运行,下载 zip 包是无法运行的。如果 clone 速度太慢,推荐使用 gitee 地址

git clone https://gitee.com/zyronon/douyin.git (中国使用)
          https://github.com/zyronon/douyin.git 
cd douyin
npm install
npm run dev

打开浏览器并访问: http://127.0.0.1:3000

注意:需要将浏览器切至手机模式,先按 F12 调出控制台,再按 Ctrl+Shift+M 才能正常预览

数据来源

视频来源于以下抖音网红

图片来自于小红书公开笔记

以上内容均是互联网公开信息

功能与建议

目前项目处于开发初期,新功能正在持续添加中,如果你对软件有任何功能与建议,欢迎在 Issues 中提出 如果你也喜欢本软件的设计思想,欢迎提交 PR,非常感谢你对我们的支持!

联系我

您可以联系我的邮箱 [email protected]

分享我其他开源项目:

**Typing Word ** - 可在网页上使用的背单词软件~
**Web Scripts ** - 一些好用的油猴脚本~

许可协议

GPL

douyin (zyronon/douyin)

Searching Database…

11.5K ·GitHub
What is this?A Vue3 + Pinia clone of Douyin (TikTok), built to showcase best practices for using Vue on mobile with a native-app-like smooth short-video feed.
Is this a real app that talks to Douyin's servers, or just a frontend demo?It's a pure frontend demo: all data lives locally in JSON, and axios-mock-adapter intercepts API calls to simulate a real backend response.
How do I run it locally?Clone the repo with git (not a zip download), then run the Vite dev server; you can also deploy it to Vercel or build/run it via the included Docker image.
Do I need a Douyin API key or any backend credentials?No — there's no real Douyin API integration; all video/user data is pre-baked into local JSON mocks served through axios-mock-adapter.
Any gotchas when previewing it in the browser?You must switch the browser into mobile device mode (F12, then Ctrl+Shift+M) to see it properly, since it's built as a mobile-only layout; it's also explicitly intended for learning/research, not commercial use.
Does it only work on mobile devices?It runs in any browser but is designed as a mobile web layout, so you view it either on an actual phone or on desktop with mobile emulation enabled.
What makes the scrolling feed feel so smooth compared to a typical web video list?The project implements an infinite vertical-swipe video feed and a custom Swiper-like carousel component from scratch, specifically tuned for mobile touch performance rather than using off-the-shelf heavy libraries.
Does it have page transition animations like a native app?Yes, the project adds route transition animations and conditional route caching so navigating between pages feels app-like, similar to how traditional news sites cache list views.
Is there a published write-up explaining how it was built?The author published a companion blog series covering the carousel component, infinite scroll, route transitions, route caching, responsive mobile sizing with rem/vh, and the CI/CD deployment pipeline.
How is it deployed and kept up to date?GitHub Actions workflows automatically deploy to GitHub Pages, sync to Gitee Pages, translate the README, and build a Docker image on changes.
Creator
zyronon
Size
615.4 MB
Stars
11.5K
Age
8y
Commits · 90 Days