Breath of Now Development Skill

Este é o skill master para desenvolvimento do ecossistema Breath of Now - uma plataforma privacy-first e offline-first de micro-apps para vida consciente.

Visão Geral

Breath of Now é um ecossistema de micro-apps sob M21 Global, Lda.

Filosofia Core

• Offline First: Browser é a fonte de verdade - funciona 100% sem internet
• Privacy First: Dados nunca saem do dispositivo sem consentimento
• Conscious Minimalism: Apps simples e focadas
• Data Sovereignty: Utilizadores são donos dos dados
• Acessibilidade: Preços regionais, múltiplos idiomas

Apps no Ecossistema

Tech Stack

Estrutura de Pastas

breathofnow/
├── .claude/                     # Documentação Claude Code
│   ├── skills/                  # Skills para Claude
│   ├── commands/                # Comandos slash
│   ├── PROJECT.md               # Visão geral
│   ├── RULES.md                 # Regras de código
│   └── supabase-schema.md       # Schema da BD
├── messages/                    # Ficheiros de tradução (4 idiomas)
├── src/
│   ├── app/[locale]/            # Páginas localizadas
│   ├── components/
│   │   ├── ui/                  # Design system
│   │   ├── shell/               # App shell unificado
│   │   └── layout/              # Header, Footer
│   ├── lib/
│   │   ├── storage/             # NEW: Storage API unificada
│   │   ├── subscription/        # NEW: Gestão de tiers
│   │   ├── db/                  # Dexie database
│   │   ├── supabase/            # Clientes Supabase
│   │   └── sync/                # Sync engine
│   ├── hooks/                   # Custom hooks (incl. useSubscription)
│   ├── stores/                  # Zustand stores
│   └── types/                   # TypeScript types
└── docs/
    └── ARCHITECTURE.md          # Arquitetura detalhada

Princípios de Desenvolvimento

Princípio 1: Usar Storage API (NEW)

// ✅ CORRECTO: Usar Storage API
import { storage, NAMESPACES } from '@/lib/storage';
const expenses = await storage.getAll(NAMESPACES.EXPENSES);

// ❌ ERRADO: Acesso direto ao Dexie
import { db } from '@/lib/db';
const expenses = await db.expenseTransactions.toArray();

Princípio 2: Usar Hooks de Subscription (NEW)

// ✅ CORRECTO: Usar hook
import { useSubscription } from '@/hooks';
const { tier, isPro, checkAppAccess } = useSubscription();

// ❌ ERRADO: Verificação manual
const isPro = user?.tier === 'pro';

Princípio 3: Zero Texto Hardcoded

// ✅ CORRECTO
const t = useTranslations('namespace');
<h1>{t('title')}</h1>

// ❌ ERRADO
<h1>Welcome</h1>

Princípio 4: TypeScript Strict Mode

// ✅ CORRECTO: Tipos de @/types
import type { AppId, User } from '@/types';

// ❌ ERRADO: any types
const handleClick = (data: any) => { ... }

Sistema de Tiers (Simplificado v4)

Design System

Cores

• Primary: #5a7d5a (Warm Sage Green)
• Secondary: #b19373 (Warm Sand)
• Accent: #df7459 (Soft Terracotta)

Fontes

• Títulos: Fraunces (font-display)
• Corpo: Source Sans 3 (font-body)
• Mono: JetBrains Mono (font-mono)

Componentes UI

Em @/components/ui/:

• Button, Input, Card, Badge, PriceSlider

APIs Disponíveis

Storage API

import { storage, NAMESPACES } from '@/lib/storage';

storage.get(namespace, key)      // Obter item
storage.set(namespace, key, val) // Guardar item
storage.delete(namespace, key)   // Apagar item
storage.getAll(namespace)        // Obter todos
storage.query(namespace, filter) // Query com filtro
storage.clear(namespace)         // Limpar namespace

Subscription Hook

import { useSubscription } from '@/hooks';

const {
  tier,           // 'free' | 'pro'
  isPro,          // boolean
  canSync,        // boolean
  showAds,        // boolean
  selectedApps,   // AppId[]
  checkAppAccess, // (appId) => boolean
} = useSubscription();

Idiomas Suportados

Comandos Rápidos

npm run dev       # Desenvolvimento
npx tsc --noEmit  # Type check
npm run lint      # Lint
npm run build     # Build

Ficheiros Críticos

• .claude/PROJECT.md - Visão geral detalhada
• .claude/RULES.md - Regras de código (incluindo Storage API)
• docs/ARCHITECTURE.md - Arquitetura v4
• .claude/supabase-schema.md - Schema da BD

Domínio

• Website: www.breathofnow.site
• App: app.breathofnow.site

Lembra-te: Cada feature deve alinhar com a missão de ajudar pessoas a viver mais conscientemente enquanto respeita a sua privacidade.