APPSPEC.mdAPPSPEC.md
Back to apps
🎬

Social · Short Video

App Clone inspired by TikTok

A 40-screen TikTok clone — For You feed, creator tools, LIVE, Friends, and profile.

Install in one line

Drops ./APPSPEC.md into your project and references it from ./CLAUDE.md. One file — screens, tokens, and interactions.

2.1k

Installs

40

Screens

260

Saves

ZIP

Not affiliated with TikTok. Reverse-engineered for educational and prototyping use only.

TikTok is a full-bleed vertical video feed with snap-scroll navigation, inline reactions, and a prominent creator pipeline. This starter includes the camera composer, effects picker, Friends tab, and messaging — the primitives you need to ship any short-video product.

React 19TypeScriptMUI 6Vite40 screens
Section 00Preview

See the clone in action

Toggle between the live prototype and the raw markdown this starter ships.

Section 01Features

What this app actually does

Parsed directly from features.md — every capability grounded in decompiled source.

Video Feed & Discovery

  • For You Feed
  • Following Feed
  • Friend Feed
  • Spotlight / Relation Feed
  • Story Feed
  • Hashtag Discovery

Video Playback

  • Multi-codec video player
  • DASH bitrate streaming
  • HDR playback
  • 3D Video
  • VR playback
  • DRM / Token Auth

Video Creation (Short Video / Camera)

  • Camera recording
  • Video duration selection
  • Upload from gallery
  • Video trimming
  • Draft management
  • Music / Sound

Effect Inspector (Advanced Effect Editing)

  • Aberration, Angle, Bending, Bling, Blur, Border, Brightness,
  • Displacement 1 / 2, Frequency, Glare, Grain, Haze, Height, H
  • Left Size / Right Size, Low quality, Glow (luminous), Textur
  • Noise, Offset / Offset 1 / Offset 2, Opacity, Pattern, Posit
  • Quantity, Radius, Velocity (rate), Ratio, Ridges, Ripple, Ro
  • Saturation, Zoom (scope), Scratch, Sharpness, Size / Size 1-

Makeup AR Tools

  • Color (AME_makeup_color), Texture (AME_makeup_finish), Style
  • Property switching
  • Toast

LIVE Streaming

  • Go Live
  • Live Drawer
  • Live Explore
  • Multi-Guest / LinkMic
  • Live Games
  • Live Gifts

AI Theater / AI Creation

  • AI Theater
  • AI Video Modes
  • Fast
  • High quality
  • Seedance 2
  • AI Image Modes

E-Commerce / TikTok Shop

  • Product Detail Page (PDP)
  • Multi-SKU selection
  • Checkout hint
  • Point of Interest (POI)
  • Product atmosphere list
  • Commerce settings
Section 02Screens

All 40 screens, documented

Every screen in the app with full UI spec. Click a group to jump into screens.md.

AccountManagementScreen
ChatConversationScreen
CommentInputScreen
CountryPickerScreen
DigitalWellbeingScreen
DirectMessagesScreen
EditProfileScreen
EffectDetailScreen
EmailConsentScreen
HomeScreen
InAppWebScreen
KidsModeDiscoverScreen
KidsModeHomeScreen
KidsModeLikedScreen
KidsModeProfileScreen
LiveBroadcastScreen
LiveEndScreen
LiveViewerScreen
LoginScreen
MediaPermissionScreen
MusicDetailScreen
NewMessageScreen
NotificationDetailScreen
OTPVerificationScreen
PasswordEntryScreen
PhoneEmailEntryScreen
PrivacySettingsScreen
SearchResultsScreen
SearchScreen
SellerShowcaseScreen
SeriesInnerFeedScreen
SettingsScreen
ShareErrorToastScreen
ShareSheetScreen
SoundChartScreen
SoundPickerScreen
VideoPlayerScreen
VideoRecordPermissionScreen
VideoRecordingScreen
VideoTrimEditScreen
Section 03Navigation

Information architecture

How screens cluster into flows. Derived automatically — good sanity check when you're rewiring the app.

Home & Dashboard

4 screens
HomeScreenKidsModeDiscoverScreenKidsModeHomeScreenSeriesInnerFeedScreen

Social & Community

4 screens
ChatConversationScreenCommentInputScreenDirectMessagesScreenNewMessageScreen

Media & Playback

9 screens
LiveBroadcastScreenMediaPermissionScreenMusicDetailScreenSoundChartScreenSoundPickerScreenVideoPlayerScreenVideoRecordPermissionScreenVideoRecordingScreen+1

Tracking & Logs

1 screens
LoginScreen

Onboarding & Auth

2 screens
EmailConsentScreenPrivacySettingsScreen

Profile & Settings

5 screens
AccountManagementScreenEditProfileScreenKidsModeProfileScreenNotificationDetailScreenSettingsScreen

Detail & Sheet

3 screens
CountryPickerScreenEffectDetailScreenShareSheetScreen

Other

12 screens
DigitalWellbeingScreenInAppWebScreenKidsModeLikedScreenLiveEndScreenLiveViewerScreenOTPVerificationScreenPasswordEntryScreenPhoneEmailEntryScreen+4
Section 04Design tokens

The design system, inferred

A coherent system derived from brand cues and app category. Use it verbatim, or override the tokens in § 05 of APPSPEC.md.

Palette

TikTok Red

#FE2C55

Cyan Accent

#25F4EE

Ink

#000000

Surface

#121212

Muted

#8A8B91

Typography

The quick brown fox jumps

Body copy at 16 / 24 — comfortable for long reads.

Meta · 12 / 16 · tracking tight

System sans · bold display · 13/15/22/34

Radius & Spacing

4px

8px

12px

pill

8px cards · pill chips · full avatar

4px base grid

Elevation

level 0

level 1

Layered shadows for cards, sheets, and floating buttons.

Section 05Interactions

Key micro-interactions

Pulled from the screens.md spec — the small moments that make the clone feel real.

Home Screen (Main Feed)

Swipe up — advances to the next video in the feed; the current video slides out and the next slides in (full-screen transition)

Following Feed

All video interactions are identical to the For You Feed (swipe, tap, like, comment, share, bookmark)

Comment Sheet

Scroll the comment list — scrolls through comments; sheet background dims the video

Share Sheet

Tap any app icon — shares the video URL/content to that app; sheet dismisses

Video Player (Full-Screen Video Playback)

Toggles playback: if playing → pauses the video and shows the play/pause button overlay; if paused → resumes the video and hides the overlay

Video Record Permission Gate

On successful permission grant: User is automatically taken to the Video Recording screen with no visible interaction required

Section 06Related apps

Other clones you might want

Same vibe, different product. All generated the same way.

Can't find what you want?

Upload your own APK

Any Android app, ~5 minutes, markdown specs ready to drop into Claude Design, Cursor, or Claude Code.

Run APPSPEC.md on an APK
TikTok App Clone — 40 Screens, Free Starter | APPSPEC.md