|
| 1 | +# E-COMMERCE NINJAS WEB APPLICATION - FRONTEND |
| 2 | + |
| 3 | +Our e-commerce web application server, developed by Team Ninjas, facilitates smooth online shopping with features like user authentication, product cataloging, and secure payments. It's built to enhance the user experience with high performance and reliability. Suitable for any online marketplace looking to grow. |
| 4 | + |
| 5 | + |
| 6 | +## Hosted Application URL |
| 7 | + |
| 8 | +[https://e-commerce-ninja-fn-staging.netlify.app/](https://e-commerce-ninja-fn-staging.netlify.app/) |
| 9 | + |
| 10 | +## Github repository |
| 11 | + |
| 12 | +[https://github.com/atlp-rwanda/e-commerce-ninjas-fe](https://github.com/atlp-rwanda/e-commerce-ninjas-fe/tree/develop) |
| 13 | + |
| 14 | + |
| 15 | +[](https://codeclimate.com/github/atlp-rwanda/e-commerce-ninjas-fe/maintainability) |
| 16 | +[](https://codeclimate.com/github/atlp-rwanda/e-commerce-ninjas-fe/test_coverage) |
| 17 | +[](https://app.netlify.com/sites/e-commerce-ninja-fn-staging/deploys) |
| 18 | +[](https://coveralls.io/github/atlp-rwanda/e-commerce-ninjas-fe) |
| 19 | +[](https://dl.circleci.com/status-badge/redirect/gh/atlp-rwanda/e-commerce-ninjas-fe/tree/develop) |
| 20 | +[](https://github.com/atlp-rwanda/e-commerce-ninjas-fe/actions/workflows/ci.yml) |
| 21 | + |
| 22 | +## Completed features |
| 23 | +- Setup empty react |
| 24 | +- Setup Redux store |
| 25 | +- Setup StoryBook documentation |
| 26 | +- Sign up page |
| 27 | +- Login/Signup with Google |
| 28 | + |
| 29 | +## Get started |
| 30 | +- Clone repository |
| 31 | + ```bash |
| 32 | + git clone https://github.com/atlp-rwanda/e-commerce-ninjas-fe |
| 33 | + ``` |
| 34 | +- Install dependencies |
| 35 | + ```bash |
| 36 | + npm install |
| 37 | + ``` |
| 38 | +- Run App - it will run on http://localhost:5000/ |
| 39 | + ```bash |
| 40 | + npm run dev |
| 41 | + ``` |
| 42 | + |
| 43 | +## StoryBook |
| 44 | + |
| 45 | +To run storybook for documentation, use this command |
| 46 | + |
| 47 | +```sh |
| 48 | +npm run storybook |
| 49 | +``` |
| 50 | + |
| 51 | +## Folder Structure |
| 52 | + |
| 53 | +- `public`: Contains static files and folder like `index.html` and images. |
| 54 | +- `src`: The main source folder for the React application. |
| 55 | + - `components`: Reusable UI components. |
| 56 | + - `pages`: Different pages/screens of the application. |
| 57 | + - `store`: Redux store setup and slices. |
| 58 | + - `stories`: StoryBook stories for UI components. |
| 59 | + - `utils`: Utility functions and helpers. |
| 60 | +- `.babelrc`: Babel configuration file. |
| 61 | +- `.eslintrc`: ESLint configuration file. |
| 62 | +- `.gitignore`: Specifies which files and directories to ignore in Git. |
| 63 | +- `package-lock.json`: Automatically generated file that describes the exact tree of dependencies. |
| 64 | +- `package.json`: Contains project metadata and dependencies. |
| 65 | +- `README.md`: The readme file you are currently reading. |
| 66 | +- `tsconfig.json`: TypeScript configuration file. |
| 67 | +- `webpack.dev.config.ts`: Webpack configuration file for development. |
| 68 | +- `webpack.prod.config.ts`: Webpack configuration file for production. |
0 commit comments