tinyship-brand
Customize TinyShip branding: app name, logo, color theme, and i18n defaults. Use when the user asks to "change app name", "customize brand", "change logo", "switch theme", "change default language", "rebrand", or "customize appearance".
How do I install this agent skill?
npx skills add https://github.com/tinyshipcn/tinyship-skills --skill tinyship-brandIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a configuration guide for branding TinyShip projects. It provides instructions for manual theme, logo, and language settings through local configuration files.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
TinyShip Brand Customization
Guide for rebranding a TinyShip project with custom name, logo, theme, and language settings.
Step 1: App Name
Edit config.ts in the project root:
export const config = {
app: {
name: 'YourAppName', // was 'TinyShip'
This name appears in page titles, the navbar, email templates, and throughout the UI.
Step 2: Logo
TinyShip supports two logo modes:
Mode A: Icon + Text (default)
- Prepare a square icon (recommended: 24x24px SVG, white fill for colored backgrounds)
- Place the file in the
public/folder of the active app (e.g.,apps/next-app/public/logo.svg) - Also place in
apps/docs-app/public/if the docs app exists - Update
config.ts:
logo: {
iconUrl: '/my-logo.svg',
fullLogoUrl: '',
iconClassName: 'bg-blue-500 rounded-full p-1',
}
Mode B: Full Logo Image
- Prepare a wide logo image (recommended: 200x40px PNG/SVG)
- Place in the active app's
public/folder - Update
config.ts:
logo: {
iconUrl: '/my-icon.svg',
fullLogoUrl: '/my-full-logo.png',
iconClassName: '',
}
Step 3: Color Theme
TinyShip includes 5 built-in color schemes:
| Scheme | Style |
|---|---|
default | Classic gray with blue-purple gradient |
claude | Warm orange tones |
cosmic-night | Deep purple, cosmic |
modern-minimal | Purple-blue minimalist |
ocean-breeze | Fresh teal-green |
Update config.ts:
theme: {
defaultTheme: 'light', // 'light' or 'dark'
defaultColorScheme: 'claude', // pick from table above
storageKey: 'yourapp-ui-theme' // change to avoid conflicts
}
Custom Theme
For a fully custom color scheme:
- Visit tweakcn.com/editor/theme
- Design your theme visually
- Export the CSS
- Create a new file in
libs/ui/styles/themes/(e.g.,my-theme.css) - Add the exported CSS with a class selector (e.g.,
.theme-my-theme) - Register the theme in the theme configuration
Read libs/ui/AGENTS.md for theme system details.
Step 4: Default Language
Update config.ts:
i18n: {
defaultLocale: 'en', // 'en' or 'zh-CN'
locales: ['en', 'zh-CN'],
cookieKey: 'NEXT_LOCALE',
autoDetect: false // set true to detect browser language
}
Step 5: Verify
- Start the dev server and check:
- Navbar shows new name/logo
- Theme colors are applied
- Default language is correct
- Toggle dark mode to verify theme works in both modes
- Switch language to verify i18n still works
Reference Files in TinyShip Repo
config.ts— main configuration file to editdocs/user-guide/basic-config.md— detailed branding documentationlibs/ui/styles/themes/— theme CSS fileslibs/ui/AGENTS.md— theme system architecture
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tinyshipcn/tinyship-skills/tinyship-brand">View tinyship-brand on skillZs</a>