https://github.com/abel3ri/spot-local

https://github.com/abel3ri/spot-local

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/abel3ri/spot-local
• Owner: abel3ri
• Created: 2024-09-07T20:59:19.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-11-13T17:59:45.000Z (about 2 months ago)
• Last Synced: 2024-11-13T18:42:55.700Z (about 2 months ago)
• Language: Dart
• Size: 1.08 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Spot-Local

Spot-Local is a mobile application developed using Flutter that allows users to discover local businesses and services based on their location. The app integrates with various APIs and uses `flutter_map` for mapping functionalities, making it easy for users to locate and learn about nearby businesses with ease. 

## Features

- **Map Integration**: Uses `flutter_map` to display businesses on an interactive map based on user location.

- **Business Directory**: Lists businesses with details, including category and location, to help users make informed choices.

- **Multi-Language Support**: Supports multiple languages, catering to users from diverse backgrounds.

- **State Management**: Manages application state effectively with GetX, ensuring smooth and responsive UI interactions.

- **API Integration**: Pulls data from external sources to provide up-to-date information about businesses and services.

- **User-Friendly UI**: Intuitive design that makes it easy for users to search and navigate between different businesses.

## Tech Stack

- **Framework**: Flutter

- **State Management**: GetX

- **Mapping**: flutter_map

- **Routing/Direction**: OSRM

- **Backend**: Express.js

- **Database**: PostgreSQL

- **ORM**: Sequelize.js

- **Image Storage**: Cloudinary

### Setup

1. Clone this repository:

    ```bash

    git clone https://github.com/abel3ri/Spot-Local.git

    cd spot-local

    ```

2. Install dependencies:

    ```bash

    flutter pub get

    ```

3. Run the app:

    ```bash

    flutter run

    ```

## Folder Structure

Here's an overview of the main folders and files in the project:

```plaintext

Spot-Local/

├── lib/

│   ├── app/

│   │   ├── modules/                # App modules and feature-specific logic

│   │   └── data/

│   │       ├── models/             # Data models

│   │       ├── providers/          # State management providers

│   │       └── repositories/       # Data repositories for handling API calls and data storage

│   ├── core/

│   │   ├── utils/                  # Utility classes and helper functions

│   │   ├── widgets/                # Reusable UI components

│   │   ├── controllers/            # Controllers for handling business logic

│   │   └── services/               # API services and backend integrations                   

├── pubspec.yaml                    # Flutter project configuration

└── README.md                       # Project README file

```

# Screens