StyleSwipe Monorepo

Vision: A next-generation fashion discovery platform combining Tinder-style discovery with utility-focused shopping. Built for high-velocity solo development using AI Agents.

Architecture: Hexagonal Monorepo

We strictly enforce a Hexagonal Architecture (Ports & Adapters) to separate the "Brain" (Core) from the "Tools" (Infrastructure/UI).

"Single Command" Workflow

We use Mise to standardize environments and Graphite for stacked changes.

1. Start

# Creates a new stacked branch (slugifies title)
mise run task feat "My New Feature"

2. Snapshot (Work in Progress)

# Backs up work to remote without a PR
# NEVER use `git commit` manually
mise run snap feat "Refactoring auth"

3. Deliver

# Lint, Test, and Submit Stack to GitHub
mise run submit

4. Release

# Version bump and tag
mise run release

Agent Instructions

If you are an AI Agent working in this repo:

1. Read the Rules: Check .agent/rules/ before touching code.
2. Respect Boundaries: Do not import convex into core. Do not put logic in ui-kit.
3. Use Tokens: Never hardcode colors in ui-kit.
4. Test Core: All logic in @app/core must have unit tests.

Setup

1. Install Tools: mise install (Installs Bun, Node, Graphite).
2. Install Deps: bun install.
3. Run Dev: bun run dev (Starts Convex, Expo, and Admin).

CI/CD Secrets

To run the Continuous Native Generation (CNG) pipeline, you must add the following secrets to your GitHub repository:

• ANDROID_KEYSTORE_BASE64: Base64 encoded release keystore
• ANDROID_KEYSTORE_PASSWORD: Password for the keystore
• ANDROID_KEY_ALIAS: Alias for the key
• ANDROID_KEY_PASSWORD: Password for the key
• IOS_CERTIFICATE_BASE64: Base64 encoded p12 certificate
• IOS_CERTIFICATE_PASSWORD: Password for the p12 certificate
• IOS_PROVISIONING_PROFILE_BASE64: Base64 encoded mobileprovision file