A new shopping experience powered by Kora
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
Table of Contents
Many small businesses across Africa lack an efficient digital presence to showcase their products and services. They often rely on traditional methods such as physical storefronts or basic social media accounts, which limits their market reach and scalability. Without access to integrated e-commerce tools, these businesses miss out on opportunities to engage a broader audience, track inventory efficiently, and accept seamless digital payments.
Additionally, physical businesses, such as resorts, arcades, restaurants, and local retail stores, often face challenges in offering flexible, contactless payment options. While many businesses use methods like POS systems or bank transfers, they struggle with tracking, managing, and labeling these payments effectively. This leads to inefficiencies, missed opportunities for improving customer satisfaction, and difficulty building loyalty among modern, tech-savvy consumers.
We have created a solution to address these challenges. Our platform, ọjà mi, empowers small businesses to establish a strong online presence, manage their inventory efficiently, and accept seamless digital payments. By leveraging our platform, businesses can:
- Showcase their products and services to a broader audience
- Track inventory and manage sales efficiently
- Accept seamless digital payments from customers
- Offer flexible, contactless payment options to customers
- Track, manage, and label payments effectively
- An innovative offline payment system
- Improve customer experience using shopping assistants and augmented reality
We were able to build this project using the following technologies:
To get a local copy up and running follow these simple example steps.
This is an example of how to list things you need to use the software and how to install them.
You can install the dependencies using npm, yarn, pnpm, or bun. You will need to have API Keys from OpenAI and Korapay to run the project.
- Get a test API Keys at https://developers.korapay.com
- Clone the repo
git clone https://github.com/owolabioromidayo/ojami.git
- Install dependencies
-
npm
npm install
-
yarn
yarn install
-
pnpm
pnpm install
-
bun
bun install
- Setup your postgres database and update the .env file with your credentials
- Setup redis-server and update the .env file with your credentials
- See the open issues for a full list of proposed features (and known issues).
The project is separated into two main parts, the frontend and the backend.
- Run the development server
npm run dev
- Run the development server
npm start
ojami/
├── node-server/ # Node.js backend for API and integration with Kora and AI Models
│ └── src/
│ └── index.ts
│ └── mikro-orm.config.ts
│ └── entities/ # Database entities
│ └── migrations/ # Database migrations
│ └── routes/ # API routes
│ └── types.ts # Type definitions
│ └── utils/ # Utility functions
│ └── middleware/ # Middleware
│ └── .env # Environment variables
│
├── client/ # Next.js frontend for the application
│ └── lib/
│ └── src/
│ └── pages/ # App pages
│ └── components/ # Reusable UI components
│ └── lib/
│ └── utils/
│ └── styles/ # Global styles
│
│
└── README.md
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE.txt for more information.