# Start all apps in development mode
bun run dev

# Start specific app
bun run dev --filter=web      # Web app only
bun run dev --filter=admin    # Admin app only
bun run dev --filter=docs     # Docs only

# Build all apps
bun run build

# Build specific app
bun run build --filter=web

# Build for Appwrite deployment
cd apps/web
bun run build:appwrite

# Type checking
bun run check-types           # All packages
cd apps/web && bun run check-types  # Specific app

# Linting
bun run lint                  # All packages
cd apps/web && bunx eslint .  # Specific app

# Formatting
bun run format                # Format all files

# Install dependencies
bun install

# Add dependency to specific app
cd apps/web
bun add package-name

# Add dependency to package
cd packages/ui
bun add package-name

# Add dev dependency
bun add -D package-name

# Add to root (affects all)
bun add -w package-name

# Create route
apps/web/src/app/[locale]/about/page.tsx

# Create server action
apps/web/src/app/actions/about.ts

# Create components
apps/web/src/components/about/hero.tsx
apps/web/src/components/about/features.tsx

# Protected route
apps/admin/src/app/(admin)/admin/settings/page.tsx

# Server action
apps/admin/src/app/actions/settings.ts

# In app
apps/web/src/components/feature/my-component.tsx

# In UI package (shared)
packages/ui/components/ui/my-component.tsx

// apps/web/src/app/actions/posts.ts
'use server';

import { createSessionClient } from '@repo/api/server';
import { revalidatePath } from 'next/cache';

export async function createPost(formData: FormData) {
  const { db, account } = await createSessionClient();
  
  // Verify auth
  const user = await account.get();
  
  // Create post
  const post = await db.createDocument(
    'database_id',
    'posts',
    ID.unique(),
    {
      title: formData.get('title'),
      content: formData.get('content'),
      authorId: user.$id,
    }
  );
  
  revalidatePath('/posts');
  
  return { success: true, postId: post.$id };
}

// app/posts/page.tsx - Server Component
import { createSessionClient } from '@repo/api/server';

export default async function PostsPage() {
  // Fetch data directly
  const { db } = await createSessionClient();
  const posts = await db.listDocuments('database_id', 'posts');
  
  return (
    <div>
      {posts.documents.map(post => (
        <PostCard key={post.$id} post={post} />
      ))}
    </div>
  );
}

// components/post-form.tsx - Client Component
'use client';

import { useState } from 'react';
import { createPost } from '@/app/actions/posts';
import { Button } from '@repo/ui/components/ui/button';

export function PostForm() {
  const [loading, setLoading] = useState(false);
  
  const handleSubmit = async (e: React.FormEvent) => {
    e.preventDefault();
    setLoading(true);
    
    const formData = new FormData(e.target as HTMLFormElement);
    await createPost(formData);
    
    setLoading(false);
  };
  
  return (
    <form onSubmit={handleSubmit}>
      <input name="title" required />
      <textarea name="content" required />
      <Button type="submit" disabled={loading}>
        {loading ? 'Creating...' : 'Create Post'}
      </Button>
    </form>
  );
}

// Add console.log in Server Components/Actions
export default async function Page() {
  console.log('Server: Rendering page');
  const data = await fetchData();
  console.log('Server: Data fetched', data);
  return <div>...</div>;
}

'use client';

export function MyComponent() {
  console.log('Client: Component mounted');
  return <div>...</div>;
}

# apps/web/.env.local
NEXT_PUBLIC_APPWRITE_ENDPOINT=https://your-appwrite.com/v1
NEXT_PUBLIC_APPWRITE_PROJECT=your-project-id
APPWRITE_API_KEY=your-api-key

# Payment
VIPPS_CLIENT_ID=your-vipps-client-id
VIPPS_CLIENT_SECRET=your-secret
VIPPS_TEST_MODE=true

// Public (client-side accessible)
const endpoint = process.env.NEXT_PUBLIC_APPWRITE_ENDPOINT;

// Server-only (never exposed to client)
const apiKey = process.env.APPWRITE_API_KEY;

# Make changes in package
cd packages/ui
# Edit components/ui/button.tsx

# Changes are immediately available in apps (hot reload)
# No need to rebuild package

# To specific app
cd apps/web
bun add zod

# To package
cd packages/payment
bun add @vippsmobilepay/sdk

# Workspace-wide (use sparingly)
bun add -w turbo

# Update collection via Appwrite Console
# Or use Appwrite CLI

cd apps/web
appwrite deploy collection

# Add new translation key
# apps/web/messages/en/common.json
{
  "welcome": "Welcome to BISO Sites"
}

# apps/web/messages/no/common.json
{
  "welcome": "Velkommen til BISO Sites"
}

# Use in components
import { useTranslations } from 'next-intl';

const t = useTranslations('common');
<h1>{t('welcome')}</h1>

# Format: type(scope): description

feat(web): add user profile page
fix(admin): correct form validation
docs(api): update API documentation
style(ui): improve button styling
refactor(payment): simplify checkout flow
test(web): add unit tests for utils
chore(repo): update dependencies

# Create feature branch
git checkout -b feat/user-profile

# Make changes and commit
git add .
git commit -m "feat(web): add user profile page"

# Push branch
git push origin feat/user-profile

# Create Pull Request on GitHub

# Find process on port
lsof -ti:3000

# Kill process
lsof -ti:3000 | xargs kill -9

# Or change port in package.json
{
  "scripts": {
    "dev": "next dev -p 3050"
  }
}

# Reinstall dependencies
rm -rf node_modules apps/*/node_modules packages/*/node_modules
bun install

# Clear Next.js cache
rm -rf apps/web/.next

# Generate Next.js types
cd apps/web
bunx next build --typegen-only

# Check types
bun run check-types

# Use Turbo cache
bun run dev  # Automatically caches

# Build only changed apps
bun run build --filter=web --force

cd apps/web
ANALYZE=true bun run build