tinyship-auth
Configure authentication providers for TinyShip: Google OAuth, GitHub OAuth, WeChat login, SMS OTP, and email/password with verification. Use when the user asks to "add google login", "configure github auth", "set up wechat login", "add SMS login", "configure authentication", "add OAuth", or "add social login".
How do I install this agent skill?
npx skills add https://github.com/tinyshipcn/tinyship-skills --skill tinyship-authIs this agent skill safe to install?
- Gen Agent Trust Hubpass
No security issues detected. The skill provides documentation and configuration examples for setting up various authentication providers.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
TinyShip Auth Provider Setup
Guide for configuring authentication methods in TinyShip. Built on Better Auth.
Available Auth Methods
| Method | Difficulty | Requirements |
|---|---|---|
| Email/Password | Simple | Already works after setup |
| Google OAuth | Medium | Google Cloud Console project |
| GitHub OAuth | Medium | GitHub OAuth App |
| WeChat Login | Complex | WeChat Open Platform + business license |
| SMS OTP | Complex | Twilio or Aliyun SMS account |
Ask the user which method(s) they want to configure, then follow the relevant section.
Email/Password (Default)
Already functional after basic setup. To enable email verification and password reset emails, configure an email provider:
- Set up Resend (simplest): get API key from resend.com
- Add to
.env:
RESEND_API_KEY="re_xxxxx"
EMAIL_DEFAULT_FROM="noreply@yourdomain.com"
Read docs/user-guide/auth/email.md for detailed email auth configuration.
Google OAuth
For detailed setup steps, read references/google-oauth.md.
Summary:
- Create project in Google Cloud Console
- Configure OAuth consent screen
- Create OAuth 2.0 credentials with redirect URI:
{APP_BASE_URL}/api/auth/callback/google - Add to
.env:
GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com"
GOOGLE_CLIENT_SECRET="GOCSPX-xxxxx"
GitHub OAuth
For detailed setup steps, read references/github-oauth.md.
Summary:
- Go to GitHub Settings > Developer settings > OAuth Apps > New
- Set callback URL:
{APP_BASE_URL}/api/auth/callback/github - Add to
.env:
GITHUB_CLIENT_ID="Ov23xxxxxxxxxx"
GITHUB_CLIENT_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
WeChat Login
For detailed setup steps, read references/wechat-login.md.
Summary:
- Register on WeChat Open Platform (requires business license)
- Create a web application
- Add to
.env:
NEXT_PUBLIC_WECHAT_APP_ID="wx_xxxxx"
VITE_WECHAT_APP_ID="wx_xxxxx"
WECHAT_APP_SECRET="xxxxx"
SMS OTP Login
For detailed setup steps, read references/sms-login.md.
Summary (Twilio):
- Create Twilio account and get credentials
- Add to
.env:
TWILIO_ACCOUNT_SID="ACxxxxx"
TWILIO_AUTH_TOKEN="xxxxx"
TWILIO_DEFAULT_FROM="+1234567890"
Summary (Aliyun):
- Enable Aliyun SMS service, create sign and template
- Add to
.env:
ALIYUN_ACCESS_KEY_ID="xxxxx"
ALIYUN_ACCESS_KEY_SECRET="xxxxx"
ALIYUN_SMS_SIGN_NAME="YourSign"
ALIYUN_SMS_TEMPLATE_CODE="SMS_000000000"
Frontend: Configure Login Buttons
After adding providers, update the social auth buttons to show/hide them:
Next.js:
Edit apps/next-app/components/social-auth.tsx:
const defaultProviders: SocialProvider[] = ['google', 'github'];
// Add or remove: 'google', 'github', 'wechat', 'phone'
Nuxt.js:
Edit apps/nuxt-app/components/SocialAuth.vue:
providers: () => ['google', 'github']
// Add or remove: 'google', 'github', 'wechat', 'phone'
TanStack Start:
Edit apps/tanstack-app/src/components/social-auth.tsx (same pattern as Next.js).
Verify
- Restart the dev server after
.envchanges - Visit
/signinand check that configured providers appear - Test the login flow for each provider
- Verify the user appears in admin panel at
/admin/users
Reference Files in TinyShip Repo
config/auth.ts— auth provider configurationlibs/auth/AGENTS.md— auth library architecturedocs/user-guide/auth/overview.md— auth documentation indexapps/next-app/components/social-auth.tsx— Next.js social auth buttonsapps/tanstack-app/src/components/social-auth.tsx— TanStack Start social auth buttonsapps/nuxt-app/components/SocialAuth.vue— Nuxt.js social auth buttons
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-auth">View tinyship-auth on skillZs</a>