feat: add PWA manifest configuration (#32)

- Install @vite-pwa/nuxt module
- Configure PWA manifest with app metadata
- Set up Workbox service worker configuration
- Add runtime caching for Supabase API
- Enable PWA dev mode for testing
- Configure icons and screenshots (placeholders for #33)

Closes #32

README.md

@@ -46,12 +46,13 @@ cd pantry
 
 ## 📚 Documentation
 
-- [**Project Plan**](docs/PROJECT_PLAN.md) — Vision, roadmap, phases
-- [**Architecture**](docs/ARCHITECTURE.md) — Tech stack, data model, design decisions
-- [**Database Schema**](docs/DATABASE.md) — Tables, relationships, RLS policies
-- [**API Reference**](docs/API.md) — Endpoints, Supabase functions
-- [**Development Guide**](docs/DEVELOPMENT.md) — Setup, workflow, conventions
-- [**Deployment**](docs/DEPLOYMENT.md) — Docker, Coolify, production setup
+- **[Getting Started](docs/development/getting-started.md)** — First-time setup (5 minutes)
+- **[Local Setup Guide](docs/development/local-setup.md)** — Detailed Docker Compose setup
+- **[Project Plan](docs/PROJECT_PLAN.md)** — Vision, roadmap, MVP phases
+- **[Architecture](docs/architecture/overview.md)** — Tech stack, design decisions
+- **[Database Schema](docs/architecture/database.md)** — Tables, RLS policies, migrations
+- **[Development Workflow](docs/development/workflow.md)** — Git flow, conventions
+- **[Full Documentation Index](docs/README.md)** — Complete docs navigation
 
 ## 🛠️ Tech Stack
 

SETUP.md

@@ -1,214 +0,0 @@
-# Pantry - Setup Guide
-
-## ✅ Current Status
-
-### Infrastructure (Complete)
-
-- **Supabase Dev Instance**: Running on Coolify
-  - URL: `https://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de`
-  - Status: ✅ Healthy
-  - Services: PostgreSQL, Auth (GoTrue), Realtime, Storage, PostgREST
-  
-### Environment Configuration (Complete)
-
-- `.env.example` - Template for all environments
-- `.env.development` - Dev credentials (Coolify Supabase)
-- `.gitignore` - Protects secrets
-
----
-
-## 🚀 Quick Start (Development)
-
-### Prerequisites
-
-- **Bun** 1.0+ (or Node.js 20+)
-- **Git** access to repository
-- **Access to Coolify** Supabase instance (credentials in `.env.development`)
-
-### Setup Steps
-
-1. **Clone Repository**
-   ```bash
-   git clone https://gitea.jeanlucmakiola.de/pantry-app/pantry.git
-   cd pantry
-   ```
-
-2. **Copy Development Environment**
-   ```bash
-   cp .env.development .env
-   ```
-
-3. **Install Dependencies** (once `app/` exists)
-   ```bash
-   cd app
-   bun install
-   ```
-
-4. **Apply Database Migrations** (once created)
-   ```bash
-   cd supabase
-   # TBD: Migration command
-   ```
-
-5. **Start Development Server**
-   ```bash
-   cd app
-   bun run dev
-   ```
-
-6. **Access App**
-   - App: `http://localhost:3000`
-   - Supabase API: `https://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de`
-
----
-
-## 🗄️ Supabase Instance Details
-
-### Endpoints
-
-| Service | URL |
-|---------|-----|
-| API (PostgREST) | `https://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de/rest/v1/` |
-| Auth | `https://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de/auth/v1/` |
-| Realtime | `wss://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de/realtime/v1/` |
-| Storage | `https://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de/storage/v1/` |
-
-### Credentials
-
-**Public (safe to use in frontend):**
-- Anon Key: In `.env.development`
-
-**Secret (server-side only):**
-- Service Role Key: In `.env.development`
-- JWT Secret: In `.env.development`
-- Postgres Password: In `.env.development`
-
-### Dashboard Access
-
-**Supabase Studio:**
-- URL: `https://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de` (check Coolify for Studio port/subdomain)
-- Username: `wJZbjs3Yd5P63cs9`
-- Password: `Qv3byDujNzYe8r7YRxhNwh3DPTvZBWtN`
-
-**Direct PostgreSQL Access** (for migrations/debugging):
-- Host: `supabase-db` (or Coolify service FQDN)
-- Database: `postgres`
-- User: `postgres`
-- Password: `55P0NVRUltRqzZYksuXTFli5iXwbQvgu`
-- Port: `5432`
-
-**MinIO (Storage):**
-- Admin User: `EaTXrXvjo1R4hsaI`
-- Admin Password: `gCZOphxAExNC17GYFwtw60WzTU0P8HW8`
-
----
-
-## 📋 Next Steps
-
-### Week 1: Foundation (In Progress)
-
-- [x] ~~Supabase dev environment setup~~ (Complete)
-- [x] ~~Environment configuration~~ (Complete)
-- [ ] Create database schema (`supabase/migrations/`)
-- [ ] Scaffold Nuxt 4 app (`app/`)
-- [ ] Implement email/password auth
-- [ ] Deploy first version to Coolify
-
-### Immediate Tasks
-
-1. **Database Schema** (#10)
-   - Create migration files in `supabase/migrations/`
-   - Tables: `inventory_items`, `products`, `tags`, `item_tags`, `units`
-   - See: `docs/DATABASE.md`
-
-2. **Nuxt Scaffold** (#8)
-   - Initialize Nuxt 4 project in `app/`
-   - Install dependencies: `@nuxtjs/supabase`, `@nuxt/ui`, Tailwind
-   - Configure `nuxt.config.ts`
-
-3. **Auth Implementation** (#11)
-   - Supabase Auth integration
-   - Login/signup pages
-   - Protected routes
-
----
-
-## 🔧 Development Workflow
-
-### Making Changes
-
-```bash
-# 1. Create feature branch
-git checkout -b feature/your-feature
-
-# 2. Make changes
-# Edit files...
-
-# 3. Test locally
-bun run dev
-
-# 4. Commit and push
-git add .
-git commit -m "feat: Your feature description"
-git push origin feature/your-feature
-
-# 5. Create PR on Gitea
-```
-
-### Database Migrations
-
-```bash
-# Create new migration
-cd supabase/migrations
-touch 001_initial_schema.sql
-
-# Edit migration file (SQL)
-# Test locally against Coolify Supabase instance
-
-# Apply migration (TBD - once we set up migration tooling)
-```
-
----
-
-## 🚨 Troubleshooting
-
-### Can't connect to Supabase
-
-**Test connection:**
-```bash
-curl -s "https://supabasekong-ewo8wssk4gs8cgg0c8kosk40.jeanlucmakiola.de/rest/v1/" \
-  -H "apikey: <ANON_KEY>"
-```
-
-Should return OpenAPI spec. If not:
-- Check Coolify service status
-- Verify URL in `.env`
-- Check network/firewall
-
-### Environment variables not loading
-
-- Ensure `.env` exists in project root
-- Check `.env` has no syntax errors
-- Restart dev server after changes
-
-### Database migration issues
-
-- Verify `SUPABASE_SERVICE_ROLE_KEY` is set
-- Check migration SQL syntax
-- Review Supabase logs in Coolify
-
----
-
-## 📚 Documentation
-
-- [Project Plan](docs/PROJECT_PLAN.md) - Vision, roadmap
-- [Architecture](docs/ARCHITECTURE.md) - Tech stack, design
-- [Database Schema](docs/DATABASE.md) - Tables, RLS, functions
-- [API Reference](docs/API.md) - Endpoints, usage
-- [Development Guide](docs/DEVELOPMENT.md) - Conventions, workflow
-- [Deployment](docs/DEPLOYMENT.md) - Docker, Coolify
-
----
-
-**Last Updated:** 2026-02-08  
-**Status:** Week 1 - Foundation in progress

app/components/inventory/AddItemForm.vue

@@ -68,37 +68,7 @@
 
       <!-- Tags -->
       <UFormGroup label="Tags" hint="Optional">
-        <div class="space-y-2">
-          <!-- Selected Tags -->
-          <div v-if="selectedTags.length > 0" class="flex flex-wrap gap-1 mb-2">
-            <UBadge 
-              v-for="tag in selectedTags" 
-              :key="tag.id"
-              :style="{ backgroundColor: tag.color }"
-              class="text-white cursor-pointer"
-              @click="removeTag(tag.id)"
-            >
-              {{ tag.icon }} {{ tag.name }} ✕
-            </UBadge>
-          </div>
-
-          <!-- Tag Selection by Category -->
-          <div v-for="category in tagCategories" :key="category.name" class="space-y-1">
-            <p class="text-xs font-medium text-gray-500 uppercase">{{ category.name }}</p>
-            <div class="flex flex-wrap gap-1">
-              <UButton
-                v-for="tag in category.tags"
-                :key="tag.id"
-                size="xs"
-                :color="isTagSelected(tag.id) ? 'primary' : 'gray'"
-                :variant="isTagSelected(tag.id) ? 'solid' : 'outline'"
-                @click="toggleTag(tag)"
-              >
-                {{ tag.icon }} {{ tag.name }}
-              </UButton>
-            </div>
-          </div>
-        </div>
+        <TagsTagPicker v-model="selectedTags" />
       </UFormGroup>
 
       <!-- Submit -->
@@ -129,7 +99,16 @@
 <script setup lang="ts">
 const { addInventoryItem, addItemTags } = useInventory()
 const { getUnits } = useUnits()
-const { getTags } = useTags()
+
+const props = defineProps<{
+  initialData?: {
+    barcode?: string
+    name?: string
+    brand?: string
+    image_url?: string
+    quantity?: string
+  }
+}>()
 
 const emit = defineEmits<{
   close: []
@@ -148,24 +127,52 @@ const form = reactive({
 const submitting = ref(false)
 const selectedTags = ref<any[]>([])
 
-// Load units and tags
+// Load units
 const units = ref<any[]>([])
-const tags = ref<any[]>([])
 
 onMounted(async () => {
-  const [unitsResult, tagsResult] = await Promise.all([
-    getUnits(),
-    getTags()
-  ])
-
+  const unitsResult = await getUnits()
   units.value = unitsResult.data || []
-  tags.value = tagsResult.data || []
 
   // Set default unit (Piece)
   const defaultUnit = units.value.find(u => u.abbreviation === 'pc')
   if (defaultUnit) {
     form.unit_id = defaultUnit.id
   }
+
+  // Pre-fill from initial data (scan-to-add flow)
+  if (props.initialData) {
+    if (props.initialData.name) {
+      form.name = props.initialData.name
+    }
+    
+    // Add brand to notes if available
+    if (props.initialData.brand) {
+      form.notes = `Brand: ${props.initialData.brand}`
+      
+      if (props.initialData.barcode) {
+        form.notes += `\nBarcode: ${props.initialData.barcode}`
+      }
+    } else if (props.initialData.barcode) {
+      form.notes = `Barcode: ${props.initialData.barcode}`
+    }
+
+    // Parse quantity if available (e.g., "750g")
+    if (props.initialData.quantity) {
+      const quantityMatch = props.initialData.quantity.match(/^([\d.]+)\s*([a-zA-Z]+)$/)
+      if (quantityMatch) {
+        form.quantity = parseFloat(quantityMatch[1])
+        // Try to match unit
+        const unitAbbr = quantityMatch[2].toLowerCase()
+        const matchedUnit = units.value.find(u => 
+          u.abbreviation.toLowerCase() === unitAbbr
+        )
+        if (matchedUnit) {
+          form.unit_id = matchedUnit.id
+        }
+      }
+    }
+  }
 })
 
 // Unit options for select
@@ -187,39 +194,6 @@ const unitOptions = computed(() => {
   ])
 })
 
-// Tag categories for display
-const tagCategories = computed(() => {
-  const categories: Record<string, any[]> = {}
-  
-  for (const tag of tags.value) {
-    const cat = tag.category
-    if (!categories[cat]) categories[cat] = []
-    categories[cat].push(tag)
-  }
-
-  return Object.entries(categories).map(([name, tags]) => ({
-    name,
-    tags
-  }))
-})
-
-// Tag selection helpers
-const isTagSelected = (tagId: string) => {
-  return selectedTags.value.some(t => t.id === tagId)
-}
-
-const toggleTag = (tag: any) => {
-  if (isTagSelected(tag.id)) {
-    removeTag(tag.id)
-  } else {
-    selectedTags.value.push(tag)
-  }
-}
-
-const removeTag = (tagId: string) => {
-  selectedTags.value = selectedTags.value.filter(t => t.id !== tagId)
-}
-
 // Validation
 const isValid = computed(() => {
   return form.name.trim().length > 0 && form.quantity > 0 && form.unit_id

app/components/inventory/InventoryCard.vue

@@ -50,15 +50,12 @@
 
       <!-- Tags -->
       <div v-if="item.tags && item.tags.length > 0" class="flex flex-wrap gap-1">
-        <UBadge 
-          v-for="tagItem in item.tags.slice(0, 3)" 
+        <TagsTagBadge
+          v-for="tagItem in item.tags.slice(0, 3)"
           :key="tagItem.tag.id"
-          :style="{ backgroundColor: tagItem.tag.color }"
-          size="xs"
-          class="text-white"
-        >
-          {{ tagItem.tag.icon }} {{ tagItem.tag.name }}
-        </UBadge>
+          :tag="tagItem.tag"
+          size="sm"
+        />
         <UBadge v-if="item.tags.length > 3" size="xs" color="gray">
           +{{ item.tags.length - 3 }}
         </UBadge>

app/components/inventory/InventoryList.vue

@@ -43,7 +43,7 @@
     <!-- Inventory Grid -->
     <div v-else class="grid gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
       <InventoryCard
-        v-for="item in items"
+        v-for="item in filteredItems"
         :key="item.id"
         :item="item"
         @edit="$emit('edit-item', item)"
@@ -59,6 +59,7 @@ const { getInventory, deleteInventoryItem, updateQuantity } = useInventory()
 
 const props = defineProps<{
   refresh?: boolean
+  tagFilters?: string[]
 }>()
 
 const emit = defineEmits<{
@@ -86,6 +87,21 @@ const loadInventory = async () => {
   loading.value = false
 }
 
+// Computed filtered items
+const filteredItems = computed(() => {
+  if (!props.tagFilters || props.tagFilters.length === 0) {
+    return items.value
+  }
+
+  // Filter items that have at least one of the selected tags
+  return items.value.filter(item => {
+    if (!item.tags || item.tags.length === 0) return false
+    
+    const itemTagIds = item.tags.map((t: any) => t.tag.id)
+    return props.tagFilters!.some(filterId => itemTagIds.includes(filterId))
+  })
+})
+
 const handleDelete = async (id: string) => {
   if (!confirm('Are you sure you want to delete this item?')) {
     return

app/components/tags/TagBadge.vue

@@ -0,0 +1,71 @@
+<template>
+  <UBadge 
+    :style="badgeStyle"
+    :class="badgeClasses"
+    v-bind="$attrs"
+  >
+    <span v-if="tag.icon" class="mr-1">{{ tag.icon }}</span>
+    <span>{{ tag.name }}</span>
+    <UButton
+      v-if="removable"
+      icon="i-heroicons-x-mark"
+      size="2xs"
+      color="white"
+      variant="link"
+      class="ml-1 -mr-1"
+      @click.stop="$emit('remove', tag.id)"
+    />
+  </UBadge>
+</template>
+
+<script setup lang="ts">
+interface Tag {
+  id: string
+  name: string
+  color: string
+  icon?: string
+  category: string
+}
+
+const props = withDefaults(defineProps<{
+  tag: Tag
+  removable?: boolean
+  size?: 'sm' | 'md' | 'lg'
+}>(), {
+  removable: false,
+  size: 'md'
+})
+
+defineEmits<{
+  remove: [tagId: string]
+}>()
+
+const badgeStyle = computed(() => ({
+  backgroundColor: props.tag.color,
+  color: getContrastColor(props.tag.color)
+}))
+
+const badgeClasses = computed(() => ({
+  'cursor-pointer': props.removable,
+  'text-xs px-2 py-1': props.size === 'sm',
+  'text-sm px-2.5 py-1': props.size === 'md',
+  'text-base px-3 py-1.5': props.size === 'lg'
+}))
+
+// Calculate contrast color for text (black or white)
+function getContrastColor(hexColor: string): string {
+  // Remove # if present
+  const hex = hexColor.replace('#', '')
+  
+  // Convert to RGB
+  const r = parseInt(hex.slice(0, 2), 16)
+  const g = parseInt(hex.slice(2, 4), 16)
+  const b = parseInt(hex.slice(4, 6), 16)
+  
+  // Calculate luminance
+  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255
+  
+  // Return white for dark colors, black for light colors
+  return luminance > 0.5 ? '#000000' : '#FFFFFF'
+}
+</script>

app/components/tags/TagFilter.vue

@@ -0,0 +1,127 @@
+<template>
+  <div class="space-y-3">
+    <div class="flex items-center justify-between">
+      <h4 class="text-sm font-semibold text-gray-700">Filter by Tags</h4>
+      <UButton
+        v-if="selectedTagIds.length > 0"
+        size="xs"
+        color="gray"
+        variant="ghost"
+        @click="clearFilters"
+      >
+        Clear
+      </UButton>
+    </div>
+
+    <!-- Selected Tags (active filters) -->
+    <div v-if="selectedTagIds.length > 0" class="flex flex-wrap gap-1">
+      <TagsTagBadge
+        v-for="tagId in selectedTagIds"
+        :key="tagId"
+        :tag="findTag(tagId)!"
+        size="sm"
+        removable
+        @remove="toggleTag"
+      />
+    </div>
+
+    <!-- Available Tags by Category -->
+    <div v-for="category in tagsByCategory" :key="category.name" class="space-y-2">
+      <p class="text-xs font-medium text-gray-500 uppercase">{{ category.name }}</p>
+      <div class="flex flex-wrap gap-1">
+        <UButton
+          v-for="tag in category.tags"
+          :key="tag.id"
+          size="xs"
+          :color="isSelected(tag.id) ? 'primary' : 'gray'"
+          :variant="isSelected(tag.id) ? 'solid' : 'soft'"
+          @click="toggleTag(tag.id)"
+        >
+          <span v-if="tag.icon">{{ tag.icon }}</span>
+          <span class="ml-1">{{ tag.name }}</span>
+        </UButton>
+      </div>
+    </div>
+
+    <!-- Loading State -->
+    <div v-if="loading" class="text-center py-4">
+      <div class="inline-block animate-spin rounded-full h-4 w-4 border-b-2 border-primary-500"></div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+interface Tag {
+  id: string
+  name: string
+  color: string
+  icon?: string
+  category: string
+}
+
+const props = defineProps<{
+  modelValue: string[]
+}>()
+
+const emit = defineEmits<{
+  'update:modelValue': [tagIds: string[]]
+}>()
+
+const { getTags } = useTags()
+
+const availableTags = ref<Tag[]>([])
+const loading = ref(true)
+
+// Load tags on mount
+onMounted(async () => {
+  const { data } = await getTags()
+  if (data) {
+    availableTags.value = data
+  }
+  loading.value = false
+})
+
+// Computed
+const selectedTagIds = computed(() => props.modelValue)
+
+const tagsByCategory = computed(() => {
+  const grouped: Record<string, Tag[]> = {}
+  
+  for (const tag of availableTags.value) {
+    if (!grouped[tag.category]) {
+      grouped[tag.category] = []
+    }
+    grouped[tag.category].push(tag)
+  }
+
+  return Object.entries(grouped).map(([name, tags]) => ({
+    name: name.charAt(0).toUpperCase() + name.slice(1),
+    tags: tags.sort((a, b) => a.name.localeCompare(b.name))
+  })).sort((a, b) => {
+    if (a.name === 'Position') return -1
+    if (b.name === 'Position') return 1
+    return a.name.localeCompare(b.name)
+  })
+})
+
+// Methods
+const isSelected = (tagId: string) => {
+  return selectedTagIds.value.includes(tagId)
+}
+
+const toggleTag = (tagId: string) => {
+  if (isSelected(tagId)) {
+    emit('update:modelValue', selectedTagIds.value.filter(id => id !== tagId))
+  } else {
+    emit('update:modelValue', [...selectedTagIds.value, tagId])
+  }
+}
+
+const clearFilters = () => {
+  emit('update:modelValue', [])
+}
+
+const findTag = (tagId: string) => {
+  return availableTags.value.find(t => t.id === tagId)
+}
+</script>

app/components/tags/TagManager.vue

@@ -0,0 +1,212 @@
+<template>
+  <div class="space-y-6">
+    <!-- Add New Tag Form -->
+    <UCard>
+      <template #header>
+        <h3 class="text-lg font-semibold">Create New Tag</h3>
+      </template>
+
+      <form @submit.prevent="handleCreate" class="space-y-4">
+        <div class="grid grid-cols-2 gap-3">
+          <UFormGroup label="Name" required>
+            <UInput 
+              v-model="newTag.name"
+              placeholder="e.g. Freezer, Vegan"
+              size="md"
+            />
+          </UFormGroup>
+
+          <UFormGroup label="Category" required>
+            <USelect
+              v-model="newTag.category"
+              :options="categoryOptions"
+              placeholder="Select category"
+              size="md"
+            />
+          </UFormGroup>
+        </div>
+
+        <div class="grid grid-cols-2 gap-3">
+          <UFormGroup label="Icon" hint="Single emoji">
+            <UInput 
+              v-model="newTag.icon"
+              placeholder="❄️"
+              maxlength="2"
+              size="md"
+            />
+          </UFormGroup>
+
+          <UFormGroup label="Color" required>
+            <div class="flex gap-2">
+              <UInput 
+                v-model="newTag.color"
+                type="color"
+                class="w-16"
+              />
+              <UInput 
+                v-model="newTag.color"
+                placeholder="#3B82F6"
+                class="flex-1"
+                size="md"
+              />
+            </div>
+          </UFormGroup>
+        </div>
+
+        <UButton 
+          type="submit"
+          color="primary"
+          :loading="creating"
+          :disabled="!isFormValid"
+        >
+          Create Tag
+        </UButton>
+      </form>
+    </UCard>
+
+    <!-- Existing Tags -->
+    <UCard>
+      <template #header>
+        <h3 class="text-lg font-semibold">Existing Tags</h3>
+      </template>
+
+      <div v-if="loading" class="text-center py-8">
+        <div class="inline-block animate-spin rounded-full h-8 w-8 border-b-2 border-primary-500"></div>
+        <p class="text-gray-600 mt-2">Loading tags...</p>
+      </div>
+
+      <div v-else-if="tagsByCategory.length === 0" class="text-center py-8">
+        <p class="text-gray-500">No tags yet. Create your first tag above!</p>
+      </div>
+
+      <div v-else class="space-y-4">
+        <div v-for="category in tagsByCategory" :key="category.name">
+          <h4 class="text-sm font-semibold text-gray-600 uppercase mb-2">
+            {{ category.name }}
+          </h4>
+          <div class="space-y-2">
+            <div
+              v-for="tag in category.tags"
+              :key="tag.id"
+              class="flex items-center justify-between p-3 bg-gray-50 rounded-lg hover:bg-gray-100"
+            >
+              <div class="flex items-center gap-3">
+                <TagsTagBadge :tag="tag" size="md" />
+                <span class="text-sm text-gray-500">{{ tag.color }}</span>
+              </div>
+              
+              <UButton
+                icon="i-heroicons-trash"
+                color="red"
+                variant="ghost"
+                size="sm"
+                @click="handleDelete(tag.id, tag.name)"
+              />
+            </div>
+          </div>
+        </div>
+      </div>
+    </UCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+const { getTags, createTag, deleteTag } = useTags()
+
+const tags = ref<any[]>([])
+const loading = ref(true)
+const creating = ref(false)
+
+const newTag = reactive({
+  name: '',
+  category: '',
+  icon: '',
+  color: '#3B82F6'
+})
+
+const categoryOptions = [
+  { label: 'Position', value: 'position' },
+  { label: 'Type', value: 'type' },
+  { label: 'Custom', value: 'custom' }
+]
+
+// Load tags on mount
+const loadTags = async () => {
+  loading.value = true
+  const { data } = await getTags()
+  if (data) {
+    tags.value = data
+  }
+  loading.value = false
+}
+
+onMounted(loadTags)
+
+// Computed
+const tagsByCategory = computed(() => {
+  const grouped: Record<string, any[]> = {}
+  
+  for (const tag of tags.value) {
+    if (!grouped[tag.category]) {
+      grouped[tag.category] = []
+    }
+    grouped[tag.category].push(tag)
+  }
+
+  return Object.entries(grouped).map(([name, tags]) => ({
+    name: name.charAt(0).toUpperCase() + name.slice(1),
+    tags: tags.sort((a, b) => a.name.localeCompare(b.name))
+  })).sort((a, b) => {
+    if (a.name === 'Position') return -1
+    if (b.name === 'Position') return 1
+    return a.name.localeCompare(b.name)
+  })
+})
+
+const isFormValid = computed(() => {
+  return newTag.name.trim() && newTag.category && newTag.color
+})
+
+// Methods
+const handleCreate = async () => {
+  if (!isFormValid.value) return
+
+  creating.value = true
+
+  const { data, error } = await createTag({
+    name: newTag.name.trim(),
+    category: newTag.category,
+    icon: newTag.icon.trim() || null,
+    color: newTag.color
+  })
+
+  if (error) {
+    alert('Failed to create tag: ' + error.message)
+  } else {
+    // Reset form
+    newTag.name = ''
+    newTag.category = ''
+    newTag.icon = ''
+    newTag.color = '#3B82F6'
+
+    // Reload tags
+    await loadTags()
+  }
+
+  creating.value = false
+}
+
+const handleDelete = async (tagId: string, tagName: string) => {
+  if (!confirm(`Delete tag "${tagName}"? This will remove it from all items.`)) {
+    return
+  }
+
+  const { error } = await deleteTag(tagId)
+
+  if (error) {
+    alert('Failed to delete tag: ' + error.message)
+  } else {
+    await loadTags()
+  }
+}
+</script>

app/components/tags/TagPicker.vue

@@ -0,0 +1,125 @@
+<template>
+  <div class="space-y-4">
+    <!-- Selected Tags -->
+    <div v-if="selectedTags.length > 0" class="flex flex-wrap gap-2">
+      <TagsTagBadge
+        v-for="tag in selectedTags"
+        :key="tag.id"
+        :tag="tag"
+        :removable="true"
+        @remove="removeTag"
+      />
+    </div>
+
+    <!-- Empty State -->
+    <div v-else class="text-sm text-gray-500 italic">
+      No tags selected
+    </div>
+
+    <!-- Tag Selection by Category -->
+    <div v-for="category in tagsByCategory" :key="category.name" class="space-y-2">
+      <h4 class="text-xs font-semibold text-gray-500 uppercase tracking-wide">
+        {{ category.name }}
+      </h4>
+      <div class="flex flex-wrap gap-2">
+        <UButton
+          v-for="tag in category.tags"
+          :key="tag.id"
+          size="sm"
+          :color="isSelected(tag.id) ? 'primary' : 'gray'"
+          :variant="isSelected(tag.id) ? 'solid' : 'outline'"
+          @click="toggleTag(tag)"
+        >
+          <span v-if="tag.icon" class="mr-1">{{ tag.icon }}</span>
+          {{ tag.name }}
+        </UButton>
+      </div>
+    </div>
+
+    <!-- Loading State -->
+    <div v-if="loading" class="text-center py-4">
+      <div class="inline-block animate-spin rounded-full h-6 w-6 border-b-2 border-primary-500"></div>
+      <p class="text-sm text-gray-500 mt-2">Loading tags...</p>
+    </div>
+
+    <!-- Empty State (no tags available) -->
+    <div v-if="!loading && availableTags.length === 0" class="text-center py-4">
+      <p class="text-gray-500">No tags available</p>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+interface Tag {
+  id: string
+  name: string
+  color: string
+  icon?: string
+  category: string
+}
+
+const props = defineProps<{
+  modelValue: Tag[]
+}>()
+
+const emit = defineEmits<{
+  'update:modelValue': [tags: Tag[]]
+}>()
+
+const { getTags } = useTags()
+
+const availableTags = ref<Tag[]>([])
+const loading = ref(true)
+
+// Load tags on mount
+onMounted(async () => {
+  const { data, error } = await getTags()
+  if (data) {
+    availableTags.value = data
+  }
+  loading.value = false
+})
+
+// Computed
+const selectedTags = computed(() => props.modelValue)
+
+const tagsByCategory = computed(() => {
+  const grouped: Record<string, Tag[]> = {}
+  
+  for (const tag of availableTags.value) {
+    if (!grouped[tag.category]) {
+      grouped[tag.category] = []
+    }
+    grouped[tag.category].push(tag)
+  }
+
+  return Object.entries(grouped).map(([name, tags]) => ({
+    name: name.charAt(0).toUpperCase() + name.slice(1),
+    tags: tags.sort((a, b) => a.name.localeCompare(b.name))
+  })).sort((a, b) => {
+    // Position category first, then others alphabetically
+    if (a.name === 'Position') return -1
+    if (b.name === 'Position') return 1
+    return a.name.localeCompare(b.name)
+  })
+})
+
+// Methods
+const isSelected = (tagId: string) => {
+  return selectedTags.value.some(t => t.id === tagId)
+}
+
+const toggleTag = (tag: Tag) => {
+  const isCurrentlySelected = isSelected(tag.id)
+  
+  if (isCurrentlySelected) {
+    removeTag(tag.id)
+  } else {
+    emit('update:modelValue', [...selectedTags.value, tag])
+  }
+}
+
+const removeTag = (tagId: string) => {
+  emit('update:modelValue', selectedTags.value.filter(t => t.id !== tagId))
+}
+</script>

app/composables/useProductLookup.ts

@@ -0,0 +1,61 @@
+// Composable for product lookup via Edge Function
+
+export interface ProductData {
+  barcode: string
+  name: string
+  brand?: string
+  quantity?: string
+  image_url?: string
+  category?: string
+  cached?: boolean
+}
+
+export const useProductLookup = () => {
+  const supabase = useSupabaseClient()
+  const isLoading = ref(false)
+  const error = ref<string | null>(null)
+
+  const lookupProduct = async (barcode: string): Promise<ProductData | null> => {
+    isLoading.value = true
+    error.value = null
+
+    try {
+      const { data, error: functionError } = await supabase.functions.invoke('product-lookup', {
+        body: { barcode }
+      })
+
+      if (functionError) {
+        console.error('Product lookup error:', functionError)
+        error.value = functionError.message || 'Failed to lookup product'
+        
+        // Return basic product data even on error
+        return {
+          barcode,
+          name: `Product ${barcode}`,
+          cached: false
+        }
+      }
+
+      return data as ProductData
+
+    } catch (err) {
+      console.error('Unexpected error during product lookup:', err)
+      error.value = err instanceof Error ? err.message : 'Unknown error'
+      
+      // Return basic product data even on error
+      return {
+        barcode,
+        name: `Product ${barcode}`,
+        cached: false
+      }
+    } finally {
+      isLoading.value = false
+    }
+  }
+
+  return {
+    lookupProduct,
+    isLoading: readonly(isLoading),
+    error: readonly(error)
+  }
+}

app/composables/useTags.ts

@@ -37,8 +37,50 @@ export const useTags = () => {
     return { data, error: null }
   }
 
+  /**
+   * Create a new tag
+   */
+  const createTag = async (tag: {
+    name: string
+    category: string
+    icon?: string | null
+    color: string
+  }) => {
+    const { data, error } = await supabase
+      .from('tags')
+      .insert(tag)
+      .select()
+      .single()
+
+    if (error) {
+      console.error('Error creating tag:', error)
+      return { data: null, error }
+    }
+
+    return { data, error: null }
+  }
+
+  /**
+   * Delete a tag
+   */
+  const deleteTag = async (tagId: string) => {
+    const { error } = await supabase
+      .from('tags')
+      .delete()
+      .eq('id', tagId)
+
+    if (error) {
+      console.error('Error deleting tag:', error)
+      return { error }
+    }
+
+    return { error: null }
+  }
+
   return {
     getTags,
-    getTagsByCategory
+    getTagsByCategory,
+    createTag,
+    deleteTag
   }
 }

app/nuxt.config.ts

@@ -5,7 +5,8 @@ export default defineNuxtConfig({
 
   modules: [
     '@nuxt/ui',
-    '@nuxt/fonts'
+    '@nuxt/fonts',
+    '@vite-pwa/nuxt'
   ],
 
   runtimeConfig: {
@@ -17,5 +18,102 @@ export default defineNuxtConfig({
 
   colorMode: {
     preference: 'light'
+  },
+
+  pwa: {
+    registerType: 'autoUpdate',
+    manifest: {
+      name: 'Pantry - Smart Inventory Manager',
+      short_name: 'Pantry',
+      description: 'Track your household pantry inventory with ease. Barcode scanning, smart organization, and multi-user support.',
+      theme_color: '#10b981',
+      background_color: '#ffffff',
+      display: 'standalone',
+      orientation: 'portrait',
+      scope: '/',
+      start_url: '/',
+      categories: ['productivity', 'lifestyle'],
+      icons: [
+        {
+          src: '/icon-192x192.png',
+          sizes: '192x192',
+          type: 'image/png',
+          purpose: 'any'
+        },
+        {
+          src: '/icon-512x512.png',
+          sizes: '512x512',
+          type: 'image/png',
+          purpose: 'any'
+        },
+        {
+          src: '/icon-192x192-maskable.png',
+          sizes: '192x192',
+          type: 'image/png',
+          purpose: 'maskable'
+        },
+        {
+          src: '/icon-512x512-maskable.png',
+          sizes: '512x512',
+          type: 'image/png',
+          purpose: 'maskable'
+        }
+      ],
+      screenshots: [
+        {
+          src: '/screenshot-mobile.png',
+          sizes: '390x844',
+          type: 'image/png',
+          form_factor: 'narrow',
+          label: 'Pantry inventory view on mobile'
+        },
+        {
+          src: '/screenshot-desktop.png',
+          sizes: '1920x1080',
+          type: 'image/png',
+          form_factor: 'wide',
+          label: 'Pantry inventory view on desktop'
+        }
+      ]
+    },
+    workbox: {
+      navigateFallback: '/',
+      globPatterns: ['**/*.{js,css,html,png,svg,ico}'],
+      cleanupOutdatedCaches: true,
+      runtimeCaching: [
+        {
+          urlPattern: /^https:\/\/api\.supabase\.co\/.*/i,
+          handler: 'NetworkFirst',
+          options: {
+            cacheName: 'supabase-api',
+            expiration: {
+              maxEntries: 100,
+              maxAgeSeconds: 60 * 60 * 24 // 24 hours
+            },
+            cacheableResponse: {
+              statuses: [0, 200]
+            }
+          }
+        },
+        {
+          urlPattern: /^https:\/\/.*\.supabase\.co\/.*/i,
+          handler: 'NetworkFirst',
+          options: {
+            cacheName: 'supabase-data',
+            expiration: {
+              maxEntries: 100,
+              maxAgeSeconds: 60 * 60 * 24 // 24 hours
+            },
+            cacheableResponse: {
+              statuses: [0, 200]
+            }
+          }
+        }
+      ]
+    },
+    devOptions: {
+      enabled: true,
+      type: 'module'
+    }
   }
 })

app/package.json

@@ -19,6 +19,7 @@
     "vue-router": "^4.6.4"
   },
   "devDependencies": {
-    "@nuxtjs/tailwindcss": "^6.14.0"
+    "@nuxtjs/tailwindcss": "^6.14.0",
+    "@vite-pwa/nuxt": "^1.1.1"
   }
 }

app/pages/index.vue

@@ -21,14 +21,29 @@
         >
           Add Manually
         </UButton>
+
+        <UButton
+          color="gray"
+          size="lg"
+          icon="i-heroicons-funnel"
+          @click="showFilters = !showFilters"
+        >
+          Filter
+        </UButton>
       </div>
     </div>
 
+    <!-- Tag Filters -->
+    <UCard v-if="showFilters" class="mb-6">
+      <TagsTagFilter v-model="selectedTagFilters" />
+    </UCard>
+
     <!-- Add Item Form (Overlay) -->
     <div v-if="showAddForm" class="fixed inset-0 z-50 flex items-start justify-center pt-20 px-4 bg-black/50">
       <div class="w-full max-w-lg">
         <AddItemForm 
-          @close="showAddForm = false"
+          :initial-data="prefilledData"
+          @close="handleCloseAddForm"
           @added="handleItemAdded"
         />
       </div>
@@ -45,6 +60,7 @@
     <InventoryList
       ref="inventoryListRef"
       :refresh="refreshKey"
+      :tag-filters="selectedTagFilters"
       @add-item="showAddForm = true"
       @edit-item="editingItem = $event"
     />
@@ -56,13 +72,44 @@ definePageMeta({
   layout: 'default'
 })
 
+const route = useRoute()
+const router = useRouter()
+
 const showAddForm = ref(false)
+const showFilters = ref(false)
 const editingItem = ref<any>(null)
 const refreshKey = ref(0)
 const inventoryListRef = ref()
+const prefilledData = ref<any>(null)
+const selectedTagFilters = ref<string[]>([])
+
+// Handle scan-to-add flow (Issue #25)
+onMounted(() => {
+  if (route.query.action === 'add') {
+    // Pre-fill data from query params (from scan)
+    prefilledData.value = {
+      barcode: route.query.barcode as string || undefined,
+      name: route.query.name as string || undefined,
+      brand: route.query.brand as string || undefined,
+      image_url: route.query.image_url as string || undefined,
+      quantity: route.query.quantity as string || undefined,
+    }
+    
+    showAddForm.value = true
+    
+    // Clean up URL
+    router.replace({ query: {} })
+  }
+})
+
+const handleCloseAddForm = () => {
+  showAddForm.value = false
+  prefilledData.value = null
+}
 
 const handleItemAdded = (item: any) => {
   showAddForm.value = false
+  prefilledData.value = null
   // Reload the inventory list
   inventoryListRef.value?.reload()
 }

app/pages/scan.vue

@@ -2,25 +2,64 @@
   <div>
     <h1 class="text-3xl font-bold text-gray-900 mb-6">Scan Item</h1>
     
-    <UCard>
-      <div class="text-center py-12">
-        <UIcon 
-          name="i-heroicons-qr-code" 
-          class="w-16 h-16 text-gray-400 mx-auto mb-4"
+    <UCard v-if="!scannedBarcode" class="mb-6">
+      <ScanBarcodeScanner 
+        @barcode-detected="handleBarcodeDetected"
+        @manual-entry="showManualEntry = true"
+      />
+    </UCard>
+
+    <!-- Product Lookup Result -->
+    <UCard v-if="productData" class="mb-6">
+      <div class="space-y-4">
+        <div class="flex items-start gap-4">
+          <img 
+            v-if="productData.image_url" 
+            :src="productData.image_url" 
+            :alt="productData.name"
+            class="w-24 h-24 object-cover rounded"
+          />
+          <div class="flex-1">
+            <h3 class="text-xl font-bold mb-1">{{ productData.name }}</h3>
+            <p v-if="productData.brand" class="text-gray-600">{{ productData.brand }}</p>
+            <p class="text-sm text-gray-500 mt-2">Barcode: {{ scannedBarcode }}</p>
+          </div>
+        </div>
+
+        <UAlert 
+          v-if="lookupError"
+          color="yellow" 
+          icon="i-heroicons-exclamation-triangle"
+          title="Product not found"
+          :description="lookupError"
         />
-        <h3 class="text-lg font-semibold text-gray-900 mb-2">
-          Barcode Scanner
-        </h3>
-        <p class="text-gray-600 mb-6">
-          This feature will be implemented in Week 3.
-        </p>
-        <UButton 
-          to="/" 
-          color="gray"
-          variant="soft"
-        >
-          Back to Inventory
-        </UButton>
+
+        <div class="flex gap-2">
+          <UButton 
+            color="primary" 
+            size="lg"
+            icon="i-heroicons-plus"
+            class="flex-1"
+            @click="addToInventory"
+          >
+            Add to Inventory
+          </UButton>
+          <UButton 
+            color="gray" 
+            size="lg"
+            @click="resetScanner"
+          >
+            Scan Again
+          </UButton>
+        </div>
+      </div>
+    </UCard>
+
+    <!-- Loading State -->
+    <UCard v-if="isLookingUp">
+      <div class="text-center py-8">
+        <div class="inline-block animate-spin rounded-full h-12 w-12 border-b-2 border-primary-500 mb-4"></div>
+        <p class="text-gray-600">Looking up product...</p>
       </div>
     </UCard>
   </div>
@@ -30,4 +69,44 @@
 definePageMeta({
   layout: 'default'
 })
+
+const scannedBarcode = ref<string | null>(null)
+const productData = ref<any>(null)
+const showManualEntry = ref(false)
+
+// Use product lookup composable
+const { lookupProduct, isLoading: isLookingUp, error: lookupError } = useProductLookup()
+
+const handleBarcodeDetected = async (barcode: string) => {
+  scannedBarcode.value = barcode
+  
+  // Fetch product data from Edge Function
+  const data = await lookupProduct(barcode)
+  
+  if (data) {
+    productData.value = data
+  }
+}
+
+const addToInventory = () => {
+  // Navigate to home page with add form open and pre-filled
+  navigateTo({
+    path: '/',
+    query: {
+      action: 'add',
+      barcode: scannedBarcode.value,
+      name: productData.value?.name || undefined,
+      brand: productData.value?.brand || undefined,
+      image_url: productData.value?.image_url || undefined,
+      quantity: productData.value?.quantity || undefined
+    }
+  })
+}
+
+const resetScanner = () => {
+  scannedBarcode.value = null
+  productData.value = null
+  lookupError.value = null
+  isLookingUp.value = false
+}
 </script>

app/pages/settings.vue

@@ -2,73 +2,65 @@
   <div>
     <h1 class="text-3xl font-bold text-gray-900 mb-6">Settings</h1>
     
-    <div class="grid gap-6 md:grid-cols-2">
-      <UCard>
-        <template #header>
-          <h3 class="text-lg font-semibold">Account</h3>
-        </template>
-        
-        <div class="space-y-4">
-          <div v-if="user">
-            <label class="text-sm font-medium text-gray-700">Email</label>
-            <p class="text-gray-900">{{ user.email }}</p>
+    <UTabs :items="tabs" v-model="activeTab">
+      <template #account>
+        <UCard class="mt-4">
+          <div class="space-y-4">
+            <h3 class="text-lg font-semibold">Account Settings</h3>
+            <p class="text-gray-600">Account management will be implemented in future updates.</p>
           </div>
-          
-          <UButton 
-            v-if="!user"
-            to="/auth/login"
-            color="primary"
-          >
-            Sign In
-          </UButton>
+        </UCard>
+      </template>
+
+      <template #tags>
+        <div class="mt-4">
+          <TagsTagManager />
         </div>
-      </UCard>
+      </template>
 
-      <UCard>
-        <template #header>
-          <h3 class="text-lg font-semibold">Tags</h3>
-        </template>
-        
-        <p class="text-gray-600">
-          Manage your custom tags here (coming in Week 2).
-        </p>
-      </UCard>
-
-      <UCard>
-        <template #header>
-          <h3 class="text-lg font-semibold">Units</h3>
-        </template>
-        
-        <p class="text-gray-600">
-          Manage your custom units here (coming in Week 2).
-        </p>
-      </UCard>
-
-      <UCard>
-        <template #header>
-          <h3 class="text-lg font-semibold">About</h3>
-        </template>
-        
-        <div class="space-y-2 text-sm text-gray-600">
-          <p><strong>Pantry</strong> v0.1.0-alpha</p>
-          <p>Self-hosted inventory management</p>
-          <a 
-            href="https://github.com/pantry-app/pantry" 
-            target="_blank"
-            class="text-primary hover:underline"
-          >
-            View on GitHub →
-          </a>
-        </div>
-      </UCard>
-    </div>
+      <template #about>
+        <UCard class="mt-4">
+          <div class="space-y-4">
+            <h3 class="text-lg font-semibold">About Pantry</h3>
+            <p class="text-gray-600">Version 0.1.0 (MVP)</p>
+            <p class="text-gray-600">Self-hosted pantry management app with barcode scanning.</p>
+            <UButton 
+              to="https://github.com/pantry-app/pantry"
+              target="_blank"
+              color="gray"
+              variant="soft"
+            >
+              View on GitHub
+            </UButton>
+          </div>
+        </UCard>
+      </template>
+    </UTabs>
   </div>
 </template>
 
 <script setup lang="ts">
-const { user } = useSupabaseAuth()
-
 definePageMeta({
   layout: 'default'
 })
+
+const activeTab = ref('tags')
+
+const tabs = [
+  {
+    key: 'tags',
+    label: 'Tags',
+    icon: 'i-heroicons-tag'
+  },
+  {
+    key: 'account',
+    label: 'Account',
+    icon: 'i-heroicons-user'
+  },
+  {
+    key: 'about',
+    label: 'About',
+    icon: 'i-heroicons-information-circle'
+  }
+]
 </script>

docs/README.md

@@ -0,0 +1,84 @@
+# Pantry Documentation
+
+Complete documentation for the Pantry household inventory management system.
+
+## 📚 Documentation Structure
+
+### 🚀 Getting Started
+
+- **[Project Overview](PROJECT_PLAN.md)** - Vision, roadmap, and MVP phases
+- **[Local Setup Guide](development/local-setup.md)** - Docker Compose development environment
+- **[Getting Started](development/getting-started.md)** - Quick start for new developers
+
+### 🏗️ Architecture
+
+- **[Architecture Overview](architecture/overview.md)** - Tech stack, design decisions, data flow
+- **[Database Schema](architecture/database.md)** - Tables, relationships, RLS policies, migrations
+- **[API Reference](architecture/api.md)** - Supabase endpoints, Edge Functions, helpers
+
+### 💻 Development
+
+- **[Development Workflow](development/workflow.md)** - Daily workflow, conventions, best practices
+- **[Git Workflow](development/git-workflow.md)** - Branching strategy, PR process, reviews
+
+### 🚢 Deployment
+
+- **[Production Deployment](deployment/production.md)** - Docker, Coolify, environment setup
+- **[CI/CD Pipeline](deployment/ci-cd.md)** - Automated testing, builds, deployments
+
+---
+
+## 🎯 Quick Links by Role
+
+### New Developer
+1. [Local Setup Guide](development/local-setup.md) - Get running in 5 minutes
+2. [Architecture Overview](architecture/overview.md) - Understand the stack
+3. [Development Workflow](development/workflow.md) - Daily development process
+
+### Feature Implementation
+1. [Database Schema](architecture/database.md) - Table structure and queries
+2. [API Reference](architecture/api.md) - Available endpoints
+3. [Git Workflow](development/git-workflow.md) - Branch naming, PR checklist
+
+### Deployment & Operations
+1. [Production Deployment](deployment/production.md) - Deploy to production
+2. [CI/CD Pipeline](deployment/ci-cd.md) - Automated workflows
+
+---
+
+## 📊 Current Status
+
+**MVP Progress:** 14/34 issues complete (41.2%)
+
+- ✅ Week 1: Database + Frontend Foundation (6/6)
+- ✅ Week 2: Core Inventory Management (8/8)
+- 🔄 Week 3: Barcode Scanning (1/5)
+- ⏸️ Week 4-6: Tag UI, PWA, Deployment (20 remaining)
+
+See [PROJECT_PLAN.md](PROJECT_PLAN.md) for detailed roadmap.
+
+---
+
+## 🤝 Contributing
+
+For contribution guidelines, see [Development Workflow](development/workflow.md).
+
+Key points:
+- Feature branches off `develop`
+- PRs require review before merge
+- Follow conventional commits
+- Write tests for new features
+
+---
+
+## 🔗 External Resources
+
+- **Repository:** https://gitea.jeanlucmakiola.de/pantry-app/pantry
+- **Supabase Docs:** https://supabase.com/docs
+- **Nuxt 4 Docs:** https://nuxt.com
+- **Open Food Facts API:** https://wiki.openfoodfacts.org/API
+
+---
+
+**Last Updated:** 2026-02-09  
+**Version:** 0.1.0-alpha (MVP in progress)

docs/development/getting-started.md

@@ -0,0 +1,189 @@
+# Getting Started with Pantry Development
+
+Welcome! This guide will get you from zero to running Pantry locally in ~5 minutes.
+
+## 🎯 What You'll Build
+
+A self-hosted kitchen inventory app with:
+- Inventory management (add, edit, delete items)
+- Tag-based organization (Fridge, Freezer, Dairy, etc.)
+- Unit conversions (g, kg, L, cups)
+- Barcode scanning (coming soon)
+- PWA features (offline, installable)
+
+## ⚡ Quick Start
+
+### Prerequisites
+
+- **Docker** & **Docker Compose** - [Install](https://docs.docker.com/get-docker/)
+- **Bun** - [Install](https://bun.sh): `curl -fsSL https://bun.sh/install | bash`
+- **Git**
+
+### One-Command Setup
+
+```bash
+# Clone the repo
+git clone https://gitea.jeanlucmakiola.de/pantry-app/pantry.git
+cd pantry
+
+# Run the setup script
+./dev.sh
+```
+
+That's it! The script will:
+1. ✅ Start Supabase services (Docker Compose)
+2. ✅ Wait for services to initialize
+3. ✅ Install frontend dependencies
+4. ✅ Launch Nuxt dev server
+
+### Access the App
+
+| Service | URL | Purpose |
+|---------|-----|---------|
+| **App** | `http://localhost:3000` | Main frontend |
+| **Supabase Studio** | `http://localhost:54323` | Database admin UI |
+| **API** | `http://localhost:54321` | Backend API |
+
+## 🎮 Try It Out
+
+1. Open `http://localhost:3000`
+2. Click **"Add Manually"** to create your first item
+3. Fill in:
+   - Name: "Milk"
+   - Quantity: 1
+   - Unit: Liter
+   - Tags: Fridge, Dairy
+   - Expiry: Set a date
+4. Click **"Add Item"** and see it in the grid!
+
+### Explore Features
+
+- **Edit item:** Click "Edit" on any card
+- **Adjust quantity:** Use +/- buttons
+- **Delete item:** Click "Delete" (confirms first)
+- **View database:** Open Supabase Studio at `:54323`
+
+## 📁 Project Structure
+
+```
+pantry/
+├── app/                      # Nuxt 4 frontend
+│   ├── components/           # Vue components
+│   │   └── inventory/        # Inventory UI (List, Card, Forms)
+│   ├── composables/          # Data hooks (useInventory, useSupabase)
+│   ├── pages/                # Routes (index, scan, settings)
+│   └── types/                # TypeScript definitions
+├── supabase/
+│   └── migrations/           # Database schema (001-005)
+├── docker-compose.yml        # Supabase services
+├── docker/
+│   └── kong.yml              # API gateway config
+└── docs/                     # Documentation
+```
+
+## 🛠️ Common Tasks
+
+### View Logs
+
+```bash
+# All services
+docker-compose logs -f
+
+# Just the database
+docker-compose logs -f db
+```
+
+### Reset Database
+
+```bash
+# Stop and remove volumes (fresh start)
+docker-compose down -v
+
+# Restart (migrations auto-apply)
+docker-compose up -d
+```
+
+### Access Database Directly
+
+```bash
+# psql CLI
+docker-compose exec db psql -U postgres -d postgres
+
+# Or use Supabase Studio (GUI)
+open http://localhost:54323
+```
+
+### Stop Everything
+
+```bash
+# Stop services (keep data)
+docker-compose stop
+
+# Stop and remove everything
+docker-compose down -v
+```
+
+## 🔍 What's Included
+
+### Database (Pre-seeded)
+
+**30 Units:**
+- Weight: g, kg, mg, lb, oz
+- Volume: mL, L, cup, tbsp, tsp
+- Count: piece, dozen, bottle, can, jar
+
+**33 Tags:**
+- Position: Fridge, Freezer, Pantry
+- Type: Dairy, Meat, Vegetables, Fruits
+- Dietary: Vegan, Gluten-Free, Organic
+- Custom: Low Stock, To Buy, Meal Prep
+
+### Features (Working Now)
+
+- ✅ Add/Edit/Delete inventory items
+- ✅ Tag selection (multi-select)
+- ✅ Unit conversions
+- ✅ Expiry date tracking with warnings
+- ✅ Responsive layout (mobile-ready)
+- ✅ Quantity quick actions (+/- buttons)
+
+### Features (Coming Soon)
+
+- ⏳ Barcode scanning (Week 3)
+- ⏳ User authentication UI
+- ⏳ Tag management
+- ⏳ PWA (offline mode)
+
+## 📚 Next Steps
+
+### Learn the Stack
+
+1. **[Architecture Overview](../architecture/overview.md)** - Tech stack and design decisions
+2. **[Database Schema](../architecture/database.md)** - Tables and relationships
+3. **[Development Workflow](workflow.md)** - Daily development process
+
+### Make Your First Change
+
+1. Pick an issue from Gitea
+2. Create a branch: `git checkout -b feature/your-feature`
+3. Make changes, test locally
+4. Commit: `git commit -m "feat: your feature"`
+5. Push and create PR
+
+### Troubleshooting
+
+See **[Local Setup Guide](local-setup.md)** for:
+- Port conflicts
+- Database connection issues
+- Frontend errors
+- Environment variables
+
+## 🤝 Need Help?
+
+- **Documentation:** Browse `/docs` folder
+- **Issues:** Create an issue on Gitea
+- **Local setup:** See [local-setup.md](local-setup.md)
+
+---
+
+**Ready to code?** Check out the [Development Workflow](workflow.md)!

supabase/functions/product-lookup/README.md

@@ -0,0 +1,83 @@
+# Product Lookup Edge Function
+
+Fetches product data from Open Food Facts API by barcode and caches results in the database.
+
+## Endpoint
+
+`POST /functions/v1/product-lookup`
+
+## Request
+
+```json
+{
+  "barcode": "8000500310427"
+}
+```
+
+## Response
+
+### Success (200)
+
+```json
+{
+  "barcode": "8000500310427",
+  "name": "Nutella",
+  "brand": "Ferrero",
+  "quantity": "750g",
+  "image_url": "https://...",
+  "category": "spreads",
+  "cached": false
+}
+```
+
+### Not Found (404)
+
+```json
+{
+  "barcode": "1234567890123",
+  "name": "Unknown Product (1234567890123)",
+  "cached": false
+}
+```
+
+### Error (500)
+
+```json
+{
+  "error": "Error message",
+  "barcode": null,
+  "name": null
+}
+```
+
+## Features
+
+- ✅ Queries Open Food Facts API
+- ✅ Caches results in `products` table
+- ✅ Returns cached data for subsequent requests
+- ✅ Handles product not found gracefully
+- ✅ CORS enabled for frontend access
+
+## Environment Variables
+
+- `SUPABASE_URL`: Auto-injected by Supabase
+- `SUPABASE_SERVICE_ROLE_KEY`: Auto-injected by Supabase
+
+## Testing
+
+```bash
+# Local (with Supabase CLI)
+supabase functions serve product-lookup
+
+# Test request
+curl -X POST http://localhost:54321/functions/v1/product-lookup \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_ANON_KEY" \
+  -d '{"barcode":"8000500310427"}'
+```
+
+## Deployment
+
+```bash
+supabase functions deploy product-lookup
+```

supabase/functions/product-lookup/index.ts

@@ -0,0 +1,140 @@
+// Product Lookup Edge Function
+// Fetches product data from Open Food Facts API by barcode
+
+import { serve } from 'https://deno.land/std@0.168.0/http/server.ts'
+import { createClient } from 'https://esm.sh/@supabase/supabase-js@2'
+
+const corsHeaders = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
+}
+
+interface ProductData {
+  barcode: string
+  name: string
+  brand?: string
+  quantity?: string
+  image_url?: string
+  category?: string
+  cached?: boolean
+}
+
+serve(async (req) => {
+  // Handle CORS preflight
+  if (req.method === 'OPTIONS') {
+    return new Response('ok', { headers: corsHeaders })
+  }
+
+  try {
+    const { barcode } = await req.json()
+
+    if (!barcode) {
+      throw new Error('Barcode is required')
+    }
+
+    // Initialize Supabase client
+    const supabaseUrl = Deno.env.get('SUPABASE_URL')!
+    const supabaseKey = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!
+    const supabase = createClient(supabaseUrl, supabaseKey)
+
+    // Check cache first (products table can store known products)
+    const { data: cachedProduct } = await supabase
+      .from('products')
+      .select('*')
+      .eq('barcode', barcode)
+      .single()
+
+    if (cachedProduct) {
+      console.log(`Cache HIT for barcode: ${barcode}`)
+      return new Response(
+        JSON.stringify({
+          barcode: cachedProduct.barcode,
+          name: cachedProduct.name,
+          brand: cachedProduct.brand,
+          quantity: cachedProduct.quantity,
+          image_url: cachedProduct.image_url,
+          category: cachedProduct.category,
+          cached: true,
+        } as ProductData),
+        { headers: { ...corsHeaders, 'Content-Type': 'application/json' } }
+      )
+    }
+
+    console.log(`Cache MISS for barcode: ${barcode}, fetching from Open Food Facts...`)
+
+    // Fetch from Open Food Facts
+    const offResponse = await fetch(
+      `https://world.openfoodfacts.org/api/v2/product/${barcode}.json`,
+      {
+        headers: {
+          'User-Agent': 'Pantry/1.0 (https://github.com/pantry-app/pantry)',
+        },
+      }
+    )
+
+    if (!offResponse.ok) {
+      throw new Error(`Open Food Facts API error: ${offResponse.status}`)
+    }
+
+    const offData = await offResponse.json()
+
+    if (offData.status !== 1 || !offData.product) {
+      // Product not found in Open Food Facts
+      return new Response(
+        JSON.stringify({
+          barcode,
+          name: `Unknown Product (${barcode})`,
+          cached: false,
+        } as ProductData),
+        { 
+          headers: { ...corsHeaders, 'Content-Type': 'application/json' },
+          status: 404
+        }
+      )
+    }
+
+    const product = offData.product
+
+    // Extract relevant data
+    const productData: ProductData = {
+      barcode,
+      name: product.product_name || product.generic_name || `Product ${barcode}`,
+      brand: product.brands || undefined,
+      quantity: product.quantity || undefined,
+      image_url: product.image_url || product.image_front_url || undefined,
+      category: product.categories || undefined,
+      cached: false,
+    }
+
+    // Cache the product in our database (upsert)
+    await supabase.from('products').upsert({
+      barcode: productData.barcode,
+      name: productData.name,
+      brand: productData.brand,
+      quantity: productData.quantity,
+      image_url: productData.image_url,
+      category: productData.category,
+    }, { onConflict: 'barcode' })
+
+    console.log(`Successfully fetched and cached product: ${productData.name}`)
+
+    return new Response(
+      JSON.stringify(productData),
+      { headers: { ...corsHeaders, 'Content-Type': 'application/json' } }
+    )
+
+  } catch (error) {
+    console.error('Error in product-lookup:', error)
+    return new Response(
+      JSON.stringify({ 
+        error: error instanceof Error ? error.message : 'Unknown error',
+        barcode: null,
+        name: null,
+      }),
+      { 
+        headers: { ...corsHeaders, 'Content-Type': 'application/json' },
+        status: 500
+      }
+    )
+  }
+})