Docs

FAQ

Frequently asked questions about TikShip

Frequently Asked Questions

General

What is TikShip?

TikShip is an enterprise-grade multi-language admin panel + blog + e-commerce system built with Next.js 16.

What databases are supported?

TikShip supports PostgreSQL, MySQL, and SQLite through Prisma ORM.

Installation

Why does installation fail?

Common issues:

  • Node.js version < 20
  • npm permission issues
  • Missing environment variables

Solution:

sudo chown -R $(whoami) ~/.npm
nvm use 20
npm ci
npm run init

How do I reset the database?

npx prisma migrate reset
npm run db:seed

After re-seeding, a new random password is generated for the superuser. Check the console output for the new credentials.

Configuration

How do I change the default theme?

Edit src/config/site.ts:

export const siteConfig = {
  theme: {
    default: 'light',        // 'light', 'dark', or 'system'
    lightTheme: 'corporate', // any DaisyUI theme name
    darkTheme: 'business',   // any DaisyUI theme name
  },
}

How do I add a new language?

  1. Create src/locales/[locale].json
  2. Update src/lib/i18n/config.ts
  3. Add translations

Payment

Which payment providers are supported?

  • Stripe (credit cards, subscriptions)
  • PayPal (PayPal account, subscriptions)

How do I test payments?

Use test mode credentials:

Stripe:

  • Test card: 4242 4242 4242 4242

PayPal:

  • Use sandbox mode

Development

How do I add a new API endpoint?

  1. Create route file: src/app/api/[endpoint]/route.ts
  2. Implement handler
  3. Add to OpenAPI spec (optional)

How do I protect an admin route?

import { requireAdminAuth } from '@/lib/admin'
import { PERMISSIONS } from '@/config/permissions'

export async function POST(req: NextRequest) {
  const { adminUserId, error } = await requireAdminAuth(req, PERMISSIONS.POST_CREATE)
  if (error) return error
  // Your logic
}

Deployment

Where can I deploy TikShip?

Recommended platforms:

  • Vercel (easiest)
  • Railway
  • Render
  • AWS/Azure/GCP

Do I need a separate database?

Yes, for production use PostgreSQL or MySQL. SQLite is only for development.

Next Steps

TikShip vs. Makerkit

TikShip vs. Makerkit — comparing two production-ready Next.js SaaS boilerplates. TikShip includes PayPal, a built-in CMS, and a complete admin panel at a lower cost with no recurring fees.

On this page

Frequently Asked QuestionsGeneralWhat is TikShip?What databases are supported?InstallationWhy does installation fail?How do I reset the database?ConfigurationHow do I change the default theme?How do I add a new language?PaymentWhich payment providers are supported?How do I test payments?DevelopmentHow do I add a new API endpoint?How do I protect an admin route?DeploymentWhere can I deploy TikShip?Do I need a separate database?Next Steps
FAQ | Tikship