Giter VIP home page Giter VIP logo

tgbot-telegramdating's Introduction

Telegram Dating mini App Installation Guide

Introduction:

This miniapp is built using the Telegram Mini App API and React JS. It facilitates users to connect with others and find matches based on preferences.

-Telegram Date (Sample Bot.)

Prerequisites:

Before you begin, ensure you have met the following requirements:

Installation:

  1. install the Backend of the Mini App Here. There is a full installation guide there.

  2. Clone the repository:

    git clone https://github.com/biruknova/telegramDating.git
  3. Change to the project's directory:

    cd telegramDating
  4. Install dependencies using npm:

    npm install
  5. Start the development server:

    npm run start
  6. Open your browser and visit http://localhost:3000 to view the app.

Configuration :

  1. Set your BASE_URL is the config.js file located in the src directory:

    const BASE_URL = "your base url";
    
    export default BASE_URL;
  2. Save the file and restart the development server.

Telegram Mini App Usage - Dating App

Overview

This miniapp is built using the Telegram Mini App API and React JS. It facilitates users to connect with others and find matches based on preferences.

Walk Through

On First Launch

  • Auto Login: Users are automatically logged in.
  • New Users:
    • Redirected to a signup page with:
      • Editable name input (autofilled).
      • Age input (Minimum age 16 years).
      • Gender selector buttons: "Male" and "Female".
    • Alt Text
    • Once all fields are valid and filled, a Telegram main button will appear labeled "Continue".
    • Clicking "Continue" registers the user and redirects them to the "Home" tab.

Bottom Navigation

There are three main tabs in the bottom navigation:

  • Home
  • Matches
  • Profile
Alt Text

Home Tab

Alt Text
  • Users are displayed in a card layout.

    • User Information Displayed:
      • User Image
      • Name
      • Age
      • Bio (if available)
    • Two action buttons:
      • Like: If clicked, you move on to the next user card. If there's a match, a match modal pops up.
      • Dislike: If clicked, you move on to the next user card.
  • If there are no users left to display, a card shows up with the message:

    "No one is available."

  • Match Modal:

    • Header: "It's a match!"
    • Displays images of both users (the user and the person they matched with).
    • Two buttons:
      • Profile: Opens the matched user's profile.
      • Continue: Closes the match popup and moves to the next user card.
  • Alt Text

Matches Tab

  • Alt Text
  • Displays all the people you've matched with. Which when clicked, navigates to the profile of the clicked match.

  • Matched User Profile:

    • Profile Picture
    • Message Button: Opens the matched user's Telegram chat.
    • Unmatch Button: Removes the matched user from your matches list.
    • Display of matched user's:
      • Username
      • Bio
      • Gender
      • Age
    • Alt Text
  • Note: If a matched user doesn't have a username and you try to message them, a snackbar notification will appear with a message. Alt Text

Profile Tab

Alt Text
  • Displays the user's:

    • Profile Picture (with an edit icon on top)
    • Username
    • Bio
    • Age
    • Gender
    • Upgrade Button: Allows users to upgrade and earn a pro badge. Payment processing is via Stripe. With the pro feature, the user will be able to see the 'Likes you' badge on the users list.
      Alt Text
  • Edit Profile:

    • Clicking on the pen icon above the profile picture opens the "Edit Profile" page.

    • Users can edit:

      • Name
      • Age (Minimum age limit: 16 years)
      • Bio
      Alt Text

tgbot-telegramdating's People

Contributors

biruknova 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.