npm - shipd - Versions diffs - 0.1.3 → 0.2.0 - Mend

shipd 0.1.3 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

package/base-package/app/globals.css +126 -0
package/base-package/app/layout.tsx +53 -0
package/base-package/app/page.tsx +15 -0
package/base-package/base.config.json +57 -0
package/base-package/components/ui/avatar.tsx +53 -0
package/base-package/components/ui/badge.tsx +46 -0
package/base-package/components/ui/button.tsx +59 -0
package/base-package/components/ui/card.tsx +92 -0
package/base-package/components/ui/chart.tsx +353 -0
package/base-package/components/ui/checkbox.tsx +32 -0
package/base-package/components/ui/dialog.tsx +135 -0
package/base-package/components/ui/dropdown-menu.tsx +257 -0
package/base-package/components/ui/form.tsx +167 -0
package/base-package/components/ui/input.tsx +21 -0
package/base-package/components/ui/label.tsx +24 -0
package/base-package/components/ui/progress.tsx +31 -0
package/base-package/components/ui/resizable.tsx +56 -0
package/base-package/components/ui/select.tsx +185 -0
package/base-package/components/ui/separator.tsx +28 -0
package/base-package/components/ui/sheet.tsx +139 -0
package/base-package/components/ui/skeleton.tsx +13 -0
package/base-package/components/ui/sonner.tsx +25 -0
package/base-package/components/ui/switch.tsx +31 -0
package/base-package/components/ui/tabs.tsx +66 -0
package/base-package/components/ui/textarea.tsx +18 -0
package/base-package/components/ui/toggle-group.tsx +73 -0
package/base-package/components/ui/toggle.tsx +47 -0
package/base-package/components/ui/tooltip.tsx +61 -0
package/base-package/components.json +21 -0
package/base-package/eslint.config.mjs +16 -0
package/base-package/lib/utils.ts +6 -0
package/base-package/middleware.ts +12 -0
package/base-package/next.config.ts +27 -0
package/base-package/package.json +49 -0
package/base-package/postcss.config.mjs +5 -0
package/base-package/public/favicon.svg +4 -0
package/base-package/tailwind.config.ts +89 -0
package/base-package/tsconfig.json +27 -0
package/dist/index.js +1858 -956
package/docs-template/README.md +74 -0
package/features/ai-chat/README.md +316 -0
package/features/ai-chat/app/api/chat/route.ts +16 -0
package/features/ai-chat/app/dashboard/_components/chatbot.tsx +39 -0
package/features/ai-chat/app/dashboard/chat/page.tsx +73 -0
package/features/ai-chat/feature.config.json +22 -0
package/features/analytics/README.md +364 -0
package/features/analytics/feature.config.json +20 -0
package/features/analytics/lib/posthog.ts +36 -0
package/features/auth/README.md +409 -0
package/features/auth/app/api/auth/[...all]/route.ts +4 -0
package/features/auth/app/dashboard/layout.tsx +15 -0
package/features/auth/app/dashboard/page.tsx +140 -0
package/features/auth/app/sign-in/page.tsx +228 -0
package/features/auth/app/sign-up/page.tsx +243 -0
package/features/auth/auth-schema.ts +47 -0
package/features/auth/components/auth/setup-instructions.tsx +123 -0
package/features/auth/feature.config.json +33 -0
package/features/auth/lib/auth-client.ts +8 -0
package/features/auth/lib/auth.ts +295 -0
package/features/auth/lib/email-stub.ts +55 -0
package/features/auth/lib/email.ts +47 -0
package/features/auth/middleware.patch.ts +43 -0
package/features/database/README.md +312 -0
package/features/database/db/drizzle.ts +48 -0
package/features/database/db/schema.ts +21 -0
package/features/database/drizzle.config.ts +13 -0
package/features/database/feature.config.json +30 -0
package/features/email/README.md +341 -0
package/features/email/emails/components/layout.tsx +181 -0
package/features/email/emails/password-reset.tsx +67 -0
package/features/email/emails/payment-failed.tsx +167 -0
package/features/email/emails/subscription-confirmation.tsx +129 -0
package/features/email/emails/welcome.tsx +100 -0
package/features/email/feature.config.json +22 -0
package/features/email/lib/email.ts +118 -0
package/features/file-upload/README.md +329 -0
package/features/file-upload/app/api/upload-image/route.ts +64 -0
package/features/file-upload/app/dashboard/upload/page.tsx +324 -0
package/features/file-upload/feature.config.json +23 -0
package/features/file-upload/lib/upload-image.ts +28 -0
package/features/marketing-landing/README.md +333 -0
package/features/marketing-landing/app/page.tsx +25 -0
package/features/marketing-landing/components/homepage/cli-workflow-section.tsx +231 -0
package/features/marketing-landing/components/homepage/features-section.tsx +152 -0
package/features/marketing-landing/components/homepage/footer.tsx +53 -0
package/features/marketing-landing/components/homepage/hero-section.tsx +112 -0
package/features/marketing-landing/components/homepage/integrations.tsx +124 -0
package/features/marketing-landing/components/homepage/navigation.tsx +116 -0
package/features/marketing-landing/components/homepage/news-section.tsx +82 -0
package/features/marketing-landing/components/homepage/pricing-section.tsx +98 -0
package/features/marketing-landing/components/homepage/testimonials-section.tsx +34 -0
package/features/marketing-landing/components/logos/BetterAuth.tsx +21 -0
package/features/marketing-landing/components/logos/NeonPostgres.tsx +41 -0
package/features/marketing-landing/components/logos/Nextjs.tsx +72 -0
package/features/marketing-landing/components/logos/Polar.tsx +7 -0
package/features/marketing-landing/components/logos/TailwindCSS.tsx +27 -0
package/features/marketing-landing/components/logos/index.ts +6 -0
package/features/marketing-landing/components/logos/shadcnui.tsx +8 -0
package/features/marketing-landing/feature.config.json +23 -0
package/features/payments/README.md +375 -0
package/features/payments/app/api/subscription/route.ts +25 -0
package/features/payments/app/dashboard/payment/_components/manage-subscription.tsx +22 -0
package/features/payments/app/dashboard/payment/page.tsx +126 -0
package/features/payments/app/success/page.tsx +123 -0
package/features/payments/feature.config.json +31 -0
package/features/payments/lib/polar-products.ts +49 -0
package/features/payments/lib/subscription.ts +148 -0
package/features/payments/payments-schema.ts +30 -0
package/features/seo/README.md +302 -0
package/features/seo/app/blog/[slug]/page.tsx +314 -0
package/features/seo/app/blog/page.tsx +107 -0
package/features/seo/app/robots.txt +13 -0
package/features/seo/app/sitemap.ts +70 -0
package/features/seo/feature.config.json +19 -0
package/features/seo/lib/seo-utils.ts +163 -0
package/package.json +3 -1

package/features/analytics/README.md ADDED Viewed

@@ -0,0 +1,364 @@
+# Analytics Module - Integration Guide
+**Module Version:** 1.0.0
+**Last Updated:** 2025-12-22
+**Standalone:** ✅ Yes (can work independently)
+---
+## Overview
+This module adds PostHog analytics integration for event tracking, user analytics, feature flags, session recording, and heatmaps.
+**Key Features:**
+- PostHog integration
+- Event tracking
+- User analytics
+- Feature flags
+- Session recording
+- Heatmaps
+- Automatic pageview tracking
+---
+## Files Added
+### Utilities/Libraries
+- `lib/posthog.ts` - PostHog provider and initialization
+---
+## Dependencies
+### Package Dependencies
+The following packages will be added to `package.json`:
+- `posthog-js@^1.248.1` - PostHog JavaScript SDK
+- `posthog-node@^4.18.0` - PostHog Node.js SDK
+### Required Modules
+- None - Analytics module is standalone
+### Optional Integration
+- **Auth Module** - For user identification and tracking
+---
+## Environment Variables
+Add these to your `.env.local`:
+```env
+# Analytics (PostHog)
+NEXT_PUBLIC_POSTHOG_KEY="phc_xxxxxxxxxxxxx"  # Your PostHog project API key
+NEXT_PUBLIC_POSTHOG_HOST="https://app.posthog.com"  # PostHog host (default: https://app.posthog.com)
+```
+**Required Variables:**
+- `NEXT_PUBLIC_POSTHOG_KEY` - Your PostHog project API key
+**Optional Variables:**
+- `NEXT_PUBLIC_POSTHOG_HOST` - PostHog host URL (defaults to `https://app.posthog.com`)
+**Where to get them:**
+- **PostHog**: [posthog.com](https://posthog.com) - Free tier available
+- Create account and project
+- Get API key from project settings
+- Use self-hosted PostHog instance if preferred
+---
+## Manual Integration Steps
+If you're appending this module to an existing project, follow these steps:
+### Step 1: Install Dependencies
+```bash
+npm install
+# or
+pnpm install
+# or
+yarn install
+```
+The append command automatically adds missing dependencies to `package.json`, but you need to install them.
+### Step 2: Add Environment Variables
+1. Copy `.env.example` to `.env.local` (if not exists)
+2. Add `NEXT_PUBLIC_POSTHOG_KEY` with your PostHog API key
+3. Optionally set `NEXT_PUBLIC_POSTHOG_HOST` if using self-hosted PostHog
+### Step 3: Integrate PostHog Provider
+Add the PostHog provider to your root layout (`app/layout.tsx`):
+```tsx
+import { PostHogProviderWrapper } from "@/lib/posthog";
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>
+        <PostHogProviderWrapper>
+          {children}
+        </PostHogProviderWrapper>
+      </body>
+    </html>
+  );
+}
+```
+### Step 4: Verify Installation
+1. Check that `lib/posthog.ts` exists
+2. Add PostHog provider to your layout
+3. Start your dev server: `npm run dev`
+4. Visit your site and check PostHog dashboard for events
+---
+## Usage Examples
+### Tracking Custom Events
+```tsx
+'use client';
+import { usePostHog } from 'posthog-js/react';
+export function MyComponent() {
+  const posthog = usePostHog();
+  const handleButtonClick = () => {
+    posthog?.capture('button_clicked', {
+      button_name: 'signup',
+      location: 'homepage',
+    });
+  };
+  return <button onClick={handleButtonClick}>Sign Up</button>;
+}
+```
+### Identifying Users
+```tsx
+'use client';
+import { usePostHog } from 'posthog-js/react';
+import { useEffect } from 'react';
+export function UserTracker({ user }: { user: { id: string; email: string } }) {
+  const posthog = usePostHog();
+  useEffect(() => {
+    if (posthog && user) {
+      posthog.identify(user.id, {
+        email: user.email,
+        // Add more user properties
+      });
+    }
+  }, [posthog, user]);
+  return null;
+}
+```
+### Using Feature Flags
+```tsx
+'use client';
+import { usePostHog } from 'posthog-js/react';
+import { useEffect, useState } from 'react';
+export function FeatureFlagComponent() {
+  const posthog = usePostHog();
+  const [isEnabled, setIsEnabled] = useState(false);
+  useEffect(() => {
+    if (posthog) {
+      posthog.onFeatureFlags(() => {
+        const enabled = posthog.isFeatureEnabled('new-feature');
+        setIsEnabled(enabled || false);
+      });
+    }
+  }, [posthog]);
+  if (!isEnabled) {
+    return null;
+  }
+  return <div>New Feature Content</div>;
+}
+```
+### Server-Side Tracking
+```typescript
+import { PostHog } from 'posthog-node';
+const posthog = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
+  host: process.env.NEXT_PUBLIC_POSTHOG_HOST || 'https://app.posthog.com',
+});
+// Track server-side events
+export async function trackEvent(userId: string, eventName: string, properties?: Record<string, any>) {
+  posthog.capture({
+    distinctId: userId,
+    event: eventName,
+    properties,
+  });
+}
+```
+---
+## Customization
+### Configuration
+- PostHog initialization is in `lib/posthog.ts`
+- Customize person profiles setting
+- Add custom properties to all events
+### Features
+- Pageview tracking is automatic
+- Custom event tracking is available
+- Feature flags are supported
+- Session recording can be enabled in PostHog dashboard
+---
+## Integration Points
+### Files That May Need Manual Updates
+**app/layout.tsx**:
+- Wrap children with `PostHogProviderWrapper`
+- Add PostHog provider to root layout
+**Components**:
+- Use `usePostHog` hook for event tracking
+- Identify users when they sign in
+- Track custom events throughout your app
+---
+## Troubleshooting
+### Common Issues
+**Issue:** "NEXT_PUBLIC_POSTHOG_KEY is not defined" error
+**Solution:**
+- Add `NEXT_PUBLIC_POSTHOG_KEY` to `.env.local`
+- Get API key from PostHog dashboard
+- Restart dev server after adding env var
+- Ensure variable name starts with `NEXT_PUBLIC_` for client-side access
+**Issue:** Events not showing in PostHog
+**Solution:**
+- Verify API key is correct
+- Check PostHog host is correct
+- Check browser console for errors
+- Verify PostHog provider is in root layout
+**Issue:** Feature flags not working
+**Solution:**
+- Ensure feature flags are enabled in PostHog dashboard
+- Check that user is identified before checking flags
+- Use `posthog.onFeatureFlags()` to wait for flags to load
+---
+## Next Steps
+After installing this module:
+1. Get PostHog API key from [posthog.com](https://posthog.com)
+2. Add `NEXT_PUBLIC_POSTHOG_KEY` to `.env.local`
+3. Integrate PostHog provider in `app/layout.tsx`
+4. Test event tracking
+5. Set up feature flags in PostHog dashboard
+6. Identify users when they sign in
+7. Track custom events throughout your app
+---
+## Related Modules
+This module works well with:
+- **Auth Module** - For user identification and tracking
+**Note:** Analytics module is optional and standalone. No other modules are required.
+---
+## Module Status
+✅ **Standalone Package** - Can be installed independently
+✅ **Event Tracking** - Automatic and custom events
+✅ **Feature Flags** - Built-in feature flag support
+✅ **User Analytics** - User identification and tracking
+✅ **Well Documented** - Comprehensive integration guide
+---
+## AI Integration Prompt
+**For AI Assistants:** Use this prompt to understand and integrate the Analytics module into an existing Next.js application.
+```
+The Analytics module has been appended to this Next.js project. Your task is to ensure it's properly integrated and functional.
+**Installed Packages:**
+- posthog-js@^1.248.1 - PostHog client-side SDK
+- posthog-node@^4.18.0 - PostHog server-side SDK
+**Files Added:**
+- lib/posthog.ts - PostHog initialization and provider wrapper
+**Environment Variables Required:**
+- NEXT_PUBLIC_POSTHOG_KEY - PostHog project API key
+- NEXT_PUBLIC_POSTHOG_HOST - PostHog host (default: https://app.posthog.com)
+**Integration Steps:**
+1. Verify lib/posthog.ts exists with PostHogProviderWrapper component
+2. Check that PostHogProviderWrapper is added to app/layout.tsx
+3. Ensure NEXT_PUBLIC_POSTHOG_KEY is set in .env.local
+4. Verify PostHog is initialized in lib/posthog.ts
+5. Test pageview tracking: Visit pages and check PostHog dashboard
+6. Test custom events: Use usePostHog hook to capture events
+7. If auth module installed: Identify users when they sign in
+**Key Integration Points:**
+- Provider wrapper: PostHogProviderWrapper must wrap app in app/layout.tsx
+- Client-side: Use usePostHog hook from 'posthog-js/react' in client components
+- Server-side: Import PostHog from 'posthog-node' for server-side tracking
+- User identification: Call posthog.identify(userId, properties) when user signs in
+- Feature flags: Use posthog.isFeatureEnabled('flag-name') to check flags
+- Automatic tracking: Pageviews are tracked automatically
+**Dependencies:**
+- OPTIONAL: Auth module (for user identification)
+- No hard dependencies on other Shipd modules
+**Common Issues to Check:**
+- If "NEXT_PUBLIC_POSTHOG_KEY is not defined": Add API key to .env.local (must start with NEXT_PUBLIC_)
+- If events not showing: Verify PostHog provider is in root layout, check browser console
+- If feature flags not working: Ensure flags are enabled in PostHog dashboard, identify users first
+- If server-side tracking fails: Check posthog-node is imported correctly
+**Next Steps After Integration:**
+- Get PostHog API key from posthog.com
+- Add NEXT_PUBLIC_POSTHOG_KEY to .env.local
+- Wrap app with PostHogProviderWrapper in app/layout.tsx
+- Test pageview tracking
+- Identify users when they sign in (if auth module installed)
+- Set up feature flags in PostHog dashboard
+- Track custom events throughout your app
+```

package/features/analytics/feature.config.json ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "name": "analytics",
+  "version": "1.0.0",
+  "description": "PostHog analytics integration with event tracking and feature flags",
+  "dependencies": {
+    "posthog-js": "^1.248.1",
+    "posthog-node": "^4.18.0"
+  },
+  "devDependencies": {},
+  "envVars": [
+    "NEXT_PUBLIC_POSTHOG_KEY",
+    "NEXT_PUBLIC_POSTHOG_HOST"
+  ],
+  "files": [
+    "lib/posthog.ts"
+  ],
+  "requires": [],
+  "conflicts": []
+}

package/features/analytics/lib/posthog.ts ADDED Viewed

@@ -0,0 +1,36 @@
+'use client';
+import posthog from 'posthog-js';
+import { PostHogProvider } from 'posthog-js/react';
+import { useEffect } from 'react';
+if (typeof window !== 'undefined') {
+  const posthogKey = process.env.NEXT_PUBLIC_POSTHOG_KEY;
+  const posthogHost = process.env.NEXT_PUBLIC_POSTHOG_HOST || 'https://app.posthog.com';
+  if (posthogKey) {
+    posthog.init(posthogKey, {
+      api_host: posthogHost,
+      person_profiles: 'identified_only', // or 'always' to create profiles for anonymous users as well
+    });
+  }
+}
+export function PostHogProviderWrapper({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    // Track pageviews
+    const handleRouteChange = () => {
+      posthog?.capture('$pageview');
+    };
+    // Track initial pageview
+    handleRouteChange();
+    return () => {
+      // Cleanup if needed
+    };
+  }, []);
+  return <PostHogProvider client={posthog}>{children}</PostHogProvider>;
+}