Code Monkey home page Code Monkey logo

sales-app's Introduction

โœจ Ecommerce Platform (Next.JS + TS)

Welcome to this ecommerce app app repository, built with Next.JS and Typescript, and of course, with a flavour of tons of awesome community open source packages.

So, while learning something new, I wanted to embrace the adventure of creating this project.

I wanted to create an app similar to Shopify but small in size, keeping the concept of creating a platform where users can create their virtual stores in one place, without worrying about the infrastructure management, layout customization or anything else.

You can find the API source code here to learn more about the features implementation on the backend.

Access this app live at: https://sales-app-demo.vercel.app

๐Ÿ“ท Here are some screenshots:

๐ŸŒ  Project status

Note: This project still under development and not all of the features stated before may be already available yet. Further details of its building, software architecture and features will be given as the app grows.

๐ŸŒณ Project structure

$PROJECT_ROOT
โ”‚
โ”œโ”€โ”€ public
โ””โ”€โ”€ src
    โ”œโ”€โ”€ assets
    โ”œโ”€โ”€ components
    โ”œโ”€โ”€ config
    โ”œโ”€โ”€ context
    โ”œโ”€โ”€ lib
    โ”œโ”€โ”€ pages
    โ”œโ”€โ”€ shared
    โ”œโ”€โ”€ styles
    โ””โ”€โ”€ types

๐Ÿพ Project Stack

  • Typescript - a superset language of Javascript that provides typechecking.
  • Vite - a next generation frontend tooling.
  • React.JS - library used to build big, fast Web apps with JavaScript.
  • Styled Components - library to write styles for components.
  • Node.JS - javascript runtime.
  • Framer-motion - for advanced layout animations.
  • Tanstack Query (known as React Query) - library that simplifies query management, state and caching.
  • Editor.JS - enables an advanced text editing in textarea with plugins (give it a try).
  • React Gallery - a library that adds a wrapper to present images.

๐ŸŽŠ Features Log

- Version v0.27.0 (beta) [First Release]

  • Accessability and layout: added support dark and light themes. Users can change theme manually or based on operating system color scheme.

  • Feed: users can create, favorite and share posts, then publish on a feed available for the public.

  • Denounce system: users can denounce products that doesn't meet the community guidelines, contain offensive or inappropriate content.

  • Cart:

    1. added support to manage (add, remove and update) cart items.
    2. added support to favorite products.
    3. cart state is stored on local storage.
  • Stores:

    1. Added support manage store products, search other stores and visualize their metrics.
    2. Added support to create and customize store profile, cover image and insert details.
    3. Support to manually activate or deactivate store (modifies public visibility of the store and all products in it).
    4. Stores can be verified (e.g. store certification).
  • Users:

    1. Users can have a customizable profile, including profile and cover images.
    2. Handle user login, registration and authentication with jwt (JSON web tokens) strategy.
    3. Users can sign a monthly subscription to maintain then stores active;
    4. View list of favorite products.
    5. Users can share public products on social media.
  • Built-in comments system: users can now add comments to products.

  • Server API: Store all data in Mongo DB, handled by a separated Node.JS with Express.JS server application.

๐Ÿ—๏ธ Testing and Local Setup

Make sure you have installed Node.js (v18.17.0 or later recommended) which also comes with npm v9.6.7.
In the project directory, you can run in terminal:

 npm run dev

Runs the app in the development mode and the server will reload when you make changes to the source code.

npm run build

Builds the app for production to the dist folder.

npm run start

Builds and starts the server in production.

โ˜˜๏ธ Find me!

๐Ÿ“ญ E-mail: [email protected]
๐Ÿ“š Github: https://github.com/KainNhantumbo
๐Ÿ“‘ Portfolio: https://codenut-dev.vercel.app
โœ’๏ธ My Blog: https://codenut-dev.vercel.app/en/blog

If you like this project, let me know by leaving a star on this repository so I can keep improving this app.๐Ÿ˜Š๐Ÿ˜˜

Best regards, Kain Nhantumbo.
โœŒ๏ธ๐Ÿ‡ฒ๐Ÿ‡ฟ Made with โค Next.JS and Typescript

๐Ÿ“œ License

Licensed under Apache License 2.0. All rights reserved.
Copyright ยฉ 2024 Kain Nhantumbo.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

sales-app's People

Contributors

kainnhantumbo avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.