# Vibes

A vertical slice monorepo for vibe-driven development. Build apps quickly, explore ideas freely, and maintain clarity through separation of concerns.

## Philosophy

Vibes is built on these principles:
- **Vibe Coding**: Development should feel natural and flow smoothly
- **Clarity**: Code organization should be immediately obvious  
- **Simplicity**: No unnecessary complexity or abstractions
- **Rapid Exploration**: Spike new ideas without friction
- **Tool Friendly**: Integrate with existing tools, don't fight them
- **Apps as Containers**: Apps merely orchestrate features

## Getting Started

```bash
# Create a new feature
pnpm vibe create my-feature

# Add a new app
pnpm vibe add mobile

# Start development
pnpm dev

# Or use the vibe tool directly
./tools/vibe.sh create my-feature
```

## Structure

```
vibes/
├── apps/               # Application entry points
├── features/           # Vertical feature slices
├── shared/            # Shared utilities and components
├── tools/             # Development tools
├── docs/              # Documentation
├── examples/          # Example implementations
├── ai-docs/           # AI assistant documentation
└── .ai/               # AI configuration and metadata
```

## Documentation

- [Getting Started](./docs/getting-started.md)
- [Architecture](./docs/architecture-visual.md)
- [Contributing](./CONTRIBUTING.md)

Happy vibing! 🌊