Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bicyblex/bicyblexStore/llms.txt

Use this file to discover all available pages before exploring further.

Bicyblex Store is a full-stack web application powering the Bicyblex Perú online presence. The platform combines a public-facing storefront — showcasing bicycles, electric motos, and electric conversion kits — with a protected admin dashboard for managing products, categories, and news articles. Everything runs on Next.js with Supabase handling authentication, the database, and image storage.

Quickstart

Clone the repo, configure Supabase credentials, and run the app locally in minutes.

Project Structure

Understand how pages, components, context, and utilities are organized.

Admin Dashboard

Manage products, categories, and news from the protected dashboard.

Supabase Setup

Create the required tables, storage buckets, and auth configuration.

What’s inside

Bicyblex Store is split into two distinct surfaces that share the same Supabase backend.

Public Storefront

Hero section, product catalog, electric motos, electric kits, features, newsletter, and footer — all driven by Supabase data.

Product Management

Full CRUD for products with per-category spec fields, image upload with automatic WebP conversion, and paginated search.

Category Management

Create and edit product categories with auto-generated URL slugs that map to dynamic spec field schemas.

News & Newsletter

Publish, edit, and delete news articles. Auto-generates slugs and excerpts; images stored in Supabase Storage.

Technology stack

LayerTechnology
FrameworkNext.js 16 (Pages Router)
Backend / DBSupabase (PostgreSQL)
AuthSupabase Auth (email + password)
StorageSupabase Storage
StylingTailwind CSS v4
Iconsreact-icons
DeploymentVercel

Get started

1

Clone and install

Clone the repository and install dependencies with your preferred package manager.
2

Configure Supabase

Create a Supabase project, set up the products, categories, and news tables, and add your credentials to .env.local.
3

Run locally

Start the development server with npm run dev and open http://localhost:3000.
4

Access the dashboard

Navigate to /login, sign in with your Supabase auth credentials, and start managing your catalog.
Ready to go deeper? Start with the Quickstart for a full step-by-step setup walkthrough, or jump straight to Supabase Setup to configure your backend.

Build docs developers (and LLMs) love