Table of Contents
Empowering you to showcase your story—one sleeve at a time. Coello One combines bold design with active performance, celebrating individuality, artistry, and the confidence to stand out. We always saw a disconnect.
You commit hours and endure the pain to wear your story on your skin. That art is a permanent badge of honor, a piece of your identity. Then, you hit the gym, the track, or the trail—another act of pure discipline—and you're forced to cover that story up. At Coello, we believe your art and your athleticism come from the same fire. Both are proof of persistence. Both are forged in commitment. Both deserve to be seen.
We aren't just a clothing brand. We are a statement. We created Coello for the niche-within-a-niche: the athlete who is also the canvas. Our one-sleeve design isn't a gimmick; it's the frame your masterpiece deserves. It's technical apparel built to perform, with a fit that finally celebrates the unique way you've chosen to express yourself. This is for everyone who knows the patience of the artist's chair and the burn of the last rep.
Welcome to Coello.
Below are some screenshots illustrating key parts of the application.
App is still in development. Once MVP is completed, more core screenshots will be added and the app will be deployed to Vercel.
Frameworks, libraries, and languages currently in play:
- Next.js 16.0.3 with the App Router
- React 19.2.x and the latest concurrent features
- Bun ≥ 1.2.21 as the runtime, package manager, and test runner
- Ant Design components styled with Tailwind CSS v4 syntax
- TypeScript 5.x across the monorepo
- Flask 3.x on Python 3.11 for the backend APIs
- Jotai atoms for shared state
- React Hook Form + Zod for typed form validation
- Drizzle ORM for schema-managed persistence
- ESLint 9 and Prettier for linting/formatting enforcement
The repository is a two-headed monorepo: the Next.js frontend lives in coello-one/ (running on Bun) and the Flask API resides in flask-server/ (Python 3.11). Install Bun ≥ 1.2.21 and Python 3.11 before you begin.
make setupmake setup installs frontend dependencies, hooks, and backend tooling in a single pass.
Frontend (Next.js + Bun)
cd coello-one
bun install
bun dev # Next.js dev server (Turbopack)
bun run build # production build
bun run lint # zero-warning ESLint policy
bun run test # Bun-powered unit + integration tests
bun run verify:locales # ensures en-GB ↔ es-ES parityBackend (Flask)
cd flask-server
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt # or make install for cached lockfiles
python app.py # serves on http://localhost:3500Use pip install -r requirements-dev.txt if you also want local Black/Ruff tooling.
make setupwires up git hooks, Bun deps, and backend tooling; rerun it after pulling new hook logic.bun run lint,bun run test, andbun run format(orformat:fix) enforce the zero-warning policy before every PR.bun run verify:localesis mandatory whenever user-facing copy changes to keep en-GB and es-ES in lockstep.- Backend helpers live under
flask-server/:make format-check,make backend-status,make backend-ci,make backend-upgrade, andmake backend-lint(-fix)keep the Python side healthy. bun audit --audit-level=highmust pass before proposing dependency upgrades; capture the report in Serena for reviewers.- Knowledge workflow: every doc or code lookup flows through Context7, and the supporting snippet IDs are logged in Serena alongside your plan + outcome notes.
- Tailwind governance: only ship v4 utilities vetted via the latest Tailwind guidance surfaced through Context7; request an upgrade if a needed utility is missing instead of backsliding to legacy syntax.
- Every method or function must ship with both unit and integration coverage. The default posture is "write the test before or alongside the implementation."
- Exemptions must be explicit. If coverage is genuinely unreasonable (for example, third-party hooks that cannot be exercised in jsdom), leave a code comment in the affected file that starts with
// TEST-WAIVER:and describes the rationale plus a tracking issue/reference. - Bias toward high-value tests. Focus on behavior that protects the user journey or business logic; redundant snapshots, boilerplate renders, or tests that fail to add signal should be skipped and explicitly called out as non-essential.
- Cross-reference in pull requests. When exceptions are used, mention the waiver in PR notes so reviewers (and future agents) can re-evaluate.
- Locale-aware Next.js App Router experience with enforced
/[locale]routing, sticky navigation, and SSR-first rendering for top Core Web Vitals. - Semantic product + training search that blends server-side relevance scoring with responsive client hydration via Bun.
- Jotai-powered bag and checkout flows instrumented through a central analytics adapter (
trackEvent) for deterministic telemetry. - Comprehensive localization pipeline (
verify:locales,useTranslations) that keeps en-GB and es-ES copy perfectly aligned. - Accessibility-first Ant Design implementations with Tailwind v4 utilities, focus handling, and motion tuned for mobile.
- Bun-native tooling (tests, formatting, Drizzle migrations) shared across the monorepo to keep backend and frontend in sync.
- AI sleeve goal-specific Trainer: from a mood board or text prompt.
- Intelligent fit + training insights: blend wearable inputs with LLM coaching to recommend sizing, recovery routines, and training blocks.
- Generative personalization engine that rewrites on-site copy and CTAs per locale, behavior, and campaign intent while tracking KPIs.
- Real-time AI observability guardrails that watch analytics streams for anomalies and open incidents before humans notice.
- Mixed-reality try-on powered by computer vision + on-device segmentation to preview one-sleeve looks in AR.
Project Link: Coello One App