Markkët

markket.place

Typescript Client

NextJS & npm utilities

For Markkëtplace stores & managers

Self host for full instnace control, or npm i individual components

Store Dashboard

New & existing users can manage their accounts, and store content

Types

Typescript definitions for development and build time checks and LLMs

Mall

Displays connect communities across multiple stores

Open source ecosystem

The markkët API is powered by Strapi, Postgres, Docker & Redis

This client uses typescript, react, tailwind, mantine, tabler & is open to community contributions

Getting Started

ENV VARS

Use the following ENV Vars to connect to our live API. This applications adds extended functionality to our markket ecosystem, with new API routes & dashboards

# // .env.example
MARKKET_URL=https://api.markket.place/
MARKKET_STORE_SLUG=next
NODE_ENV=development
MARKKET_API_KEY=

First, run the development server:

We recommend using Turbo

turbo dev

Admin || Markket instance

When self-hosting the API, you can create an API KEY to perform administrative operations

Is necesary to enable /dashboard and other functionalities for users in your instance

ENV VARS

Configure your instance with the following variables, refer to .env.example for defaults

NODE_ENV=development
NEXT_PUBLIC_MARKKET_STORE_SLUG=next
NEXT_PUBLIC_MARKKET_API=https://api.markket.place/
NEXT_PUBLIC_MARKKETPLACE_URL=http://localhost:4020/

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Mobile Domain Association

This repo ships public mobile domain association files for the production domain:

• public/.well-known/apple-app-site-association
• public/apple-app-site-association
• public/.well-known/assetlinks.json

These files are intentionally public and are not secrets. They must match the exact deployed domain, iOS app ID, Android package name, and Android signing certificate fingerprint.

If you fork or redeploy this project on a different domain, update these files for your own app identifiers and certificates before enabling Universal Links or Android App Links.

API

API routes live in the app/api

Add JSDoc comments in the correct format to generate documentation & perform sample requests, using Swagger

Markket Next extends the functionality from the Markket APIc

• App router documentation
• API Docs (Autogenerated with Swagger)
• Strapi 5 rest API docs
• Markket API github

UI

Markket

Mantine

Using Mantine with NextJS

Tailwind

React

Tabler/icons-react

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API
• Learn Next.js - an interactive Next.js tutorial
• Turbo