Skip to content

Repository files navigation

Crypto Addiction Awareness

Crypto Prices, but with how many times you checked them today

πŸš€ Live Demo

License: MIT React TypeScript Vite

πŸ“± Preview

CryptoMind App Screenshot

CryptoMind in action: tracking checking behavior while displaying real-time crypto prices

🎯 About

Many people check crypto prices too often, leading to addiction. This app tracks how many times you check crypto prices today, providing insights, statistics, and tips to help you reduce addiction by integrating awareness into your checking frequency and helping you manage your crypto habits.

Key Features

  • πŸ“Š Real-time Crypto Prices: Live cryptocurrency price tracking
  • πŸ”’ Checking Frequency Counter: Tracks how many times you've checked prices today
  • πŸ“ˆ Behavioral Analytics: Visualize your checking patterns over time
  • 🧠 Addiction Awareness: Insights and tips to help reduce compulsive checking
  • πŸ“± Modern UI: Dark, stylish, and responsive design
  • πŸ’Ύ Local Data Storage: All tracking data stored locally for privacy

πŸ—οΈ Architecture

Chart addict awareness app
Concept: dark stylish modern crypto price list table app, but it tracks checking frequency, and logging and visualize with localStorage.
Impact: Behavioral improvement for crypto investors avoiding addiction.
Uniqueness: Psychology meets local data persistence.

πŸš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/yuis-ice/crypto-addiction-awareness.git
cd crypto-addiction-awareness
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and navigate to http://localhost:5173

Building for Production

npm run build

The built files will be in the dist directory.

πŸ› οΈ Technology Stack

  • Frontend: React 18.3.1 with TypeScript
  • Build Tool: Vite 5.4.2
  • Styling: Tailwind CSS 3.4.1
  • Icons: Lucide React
  • Data Storage: localStorage (client-side)
  • Linting: ESLint 9.9.1

πŸ“ Project Structure

src/
β”œβ”€β”€ components/           # React components
β”‚   β”œβ”€β”€ BehaviorInsights.tsx   # Addiction awareness insights
β”‚   β”œβ”€β”€ CheckingChart.tsx      # Frequency visualization
β”‚   β”œβ”€β”€ CheckingStats.tsx      # Statistics display
β”‚   └── CryptoTable.tsx        # Crypto price table
β”œβ”€β”€ hooks/               # Custom React hooks
β”‚   β”œβ”€β”€ useCheckingTracker.ts  # Checking frequency logic
β”‚   └── useCryptoData.ts       # Crypto data fetching
β”œβ”€β”€ types/               # TypeScript type definitions
β”‚   └── index.ts
β”œβ”€β”€ utils/               # Utility functions
β”‚   └── storage.ts       # localStorage helpers
β”œβ”€β”€ App.tsx             # Main application component
β”œβ”€β”€ main.tsx           # Application entry point
└── index.css          # Global styles

🎯 Core Concept

This application combines real-time cryptocurrency price tracking with behavioral psychology to help users become more aware of their checking habits. By displaying a counter that increments each time you view the prices, it creates conscious awareness of potentially addictive behaviors.

How It Works

  1. Track: Every time you open the app, it increments your daily checking counter
  2. Visualize: Charts and statistics show your checking patterns over time
  3. Reflect: Behavioral insights help you understand your habits
  4. Improve: Awareness naturally leads to more mindful checking behavior

πŸ“Š Features in Detail

Checking Frequency Tracking

  • Automatic counting when app is opened
  • Daily, weekly, and monthly statistics
  • Visual charts showing patterns over time

Behavioral Insights

  • Personalized tips based on your checking frequency
  • Psychology-backed advice for reducing addiction
  • Progress tracking and milestone celebrations

Crypto Price Display

  • Real-time price updates for major cryptocurrencies
  • Clean, modern table interface
  • Price change indicators

🀝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes
  4. Run linting: npm run lint
  5. Commit your changes: git commit -m 'Add amazing feature'
  6. Push to the branch: git push origin feature/amazing-feature
  7. Open a Pull Request

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Star History

If this project helps you develop healthier crypto habits, please consider giving it a star!

πŸ”— Links

⚠️ Disclaimer

This application is for educational and awareness purposes only. It is not financial advice, and cryptocurrency investments carry significant risks. Always do your own research and consider your financial situation before making investment decisions.


Built with ❀️ for healthier crypto habits