Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chetachiezikeuzor/tobi-ecommerce-app
Tobi is a full-stack plant e-commerce application built in Angular and Spring Boot.
https://github.com/chetachiezikeuzor/tobi-ecommerce-app
angular ecommerce java javascript spring-boot typescript
Last synced: about 1 month ago
JSON representation
Tobi is a full-stack plant e-commerce application built in Angular and Spring Boot.
- Host: GitHub
- URL: https://github.com/chetachiezikeuzor/tobi-ecommerce-app
- Owner: chetachiezikeuzor
- Created: 2022-01-18T19:13:25.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-03-15T00:08:27.000Z (over 2 years ago)
- Last Synced: 2024-05-02T06:04:09.371Z (7 months ago)
- Topics: angular, ecommerce, java, javascript, spring-boot, typescript
- Language: TypeScript
- Homepage:
- Size: 108 MB
- Stars: 5
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Tobi
A full-stack e-commerce web application
## Table of Contents
- [About](#about)
- [Getting Started](#getting_started)
- [Usage](#usage)
- [Running Tests](#tests)
- [Built Using](#built_using)
- [Author](#author)
Tobi is an full-stack e-commerce web application built in Angular and Java Spring Boot. The application was created and designed to be an online marketplace for plant products. Features include: routing, Stripe credit card payments, application security and more.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See [testing](#tests) for notes on how to test the project after installation.
### Prerequisites
These are the tools and technologies that you'll need to get this project running:
| Tool | Purpose |
| ---- | ------------------------------------------------------------------------------ |
| node | For running JavaScript code from command-line |
| nvm | Node Version Manager |
| npm | Node Package Manager: Download new node package and features. Similar to Maven |
| tsc | TypeScript Compiler |
| Java | Server-side |
### Installing
Installing the project is quite simple. In your terminal, navigate to the location by which you would like to house the repository. You can use the following command:
```
cd
```
Copy the repository URL by clicking "Code" and choosing the "HTTPS" method (you can configure this step as you wish). Use the following command in yout terminal to clone the repository.
```
git clone
```
You now have a local clone of this project. What you will need to dofirst is configure your `application.properties` within the `backend` directory of the project. Here is a template to get you started.
```
server.port=8008
spring.jpa.hibernate.ddl-auto=create
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/tobi-ecommerce
spring.datasource.username=username
spring.datasource.password=password
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
spring.jpa.show-sql=true
spring.jpa.format-sql=true
spring.data.rest.base-path=/api
```
You'll need to provide your own username and password for your local instance. This will allow for Spring Boot to have access to your database. You may also redefine the server port as you wish.
Once you have this finished, you can test your api end points in an application like Postman. Use the dummy SQL data provided within the project. Run this within MySQL Workbench and you should have newly created items within your database. Now run this endpoint in Postman to ensure that your data is accessible forthe frontend.
```
GET http://localhost:8008/api
GET http://localhost:8008/api/products
GET http://localhost:8008/api/product-categories
```
You're now ready to run the frontend side of the project. Navigate to the frontend folder and start the Angular server using this command
```
ng serve --open
```
or
```
ng serve --o
```
This will build the frontend files and automatically open your browser to `http://localhost:4200/`.
- [Java](https://www.java.com/en/) - Server-side
- [Spring Boot](https://spring.io) - Web Server
- [MySQL](https://www.mysql.com) - Database
- [Angular](https://angular.io) - User Interface
- [@Chetachi](https://github.com/chetachiezikeuzor)