Overview

Additional setup and customisation guides for ShipSafe.

This section contains supplementary guides for customising and extending ShipSafe beyond the core functionality. These guides help you personalize your app and solve common issues.

What's covered:

Branding and visual customisation
Theme customisation
Email template customisation
Cookies and consent (essential vs analytics)
Cursor AI workflow and prompts
Useful resources and tools
Troubleshooting common issues

Customisation Guides

Branding Setup

Customise logos, favicons, and branding elements:

Replace app logo
Set up favicons
Create metadata images (Open Graph, Twitter)
Update app name and description
Customise colours and theme

Use when: You want to replace ShipSafe branding with your own

Custom Themes

Create custom DaisyUI themes:

Use existing DaisyUI themes
Create custom themes
Theme color structure
Dark/light mode support
Theme best practices

Use when: You want to customise the visual appearance

Email Templates

Customise transactional email copy and Resend templates.

Customise Firebase Auth templates
Create custom email templates
Email template best practices
Integrate email services
Template examples

Use when: You want to customise password-reset or product emails

Cookies

Essential cookie names, and how to enable a consent banner when you add analytics.

Use when: You are adding Plausible/GA, or documenting cookie policy

Cursor AI Workflow

Accelerate development with AI:

Cursor Rules - How .cursorrules helps AI understand your project
Cursor Prompts - Ready-to-use prompt library (cursor_prompts.md)
ChatGPT Prompts - Product development prompts (PRD generation, branding)
Workflow Examples - Complete feature development workflows
Best Practices - Tips for effective AI-assisted development

Key Files:

.cursorrules - Cursor AI configuration (in root)
cursor_prompts.md - Prompt library with 50+ ready-to-use prompts (in root)

Use when: You want to leverage AI for faster development

Resources & Help

Useful Resources

Helpful tools and resources:

Design resources (illustrations, icons)
Development tools
Analytics and monitoring services
Email services
Logo and asset generators
Learning resources

Use when: You need tools, assets, or learning materials

Troubleshooting

Common issues and solutions:

Build and development issues
Authentication issues
Payment and Stripe issues
Environment variable issues
API route issues
Database and Firestore issues
Deployment issues
Performance issues

Use when: You encounter problems or errors

Quick Reference

Customisation Checklist

Branding Setup - Replace logos and branding
Custom Themes - Customise theme colours
Email Templates - Customise emails
Cookies - Essential cookies + optional consent
Cursor AI Workflow - Set up AI-assisted development

Resources

Useful Resources - Find tools and assets
Troubleshooting - Solve problems