Skip to content

samigulec/One-Word

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

37 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ One Word

One Word Logo

Learn a new word every day. Build your vocabulary, one word at a time.

React Native Expo TypeScript License

Features โ€ข Screenshots โ€ข Installation โ€ข Tech Stack โ€ข Contributing


โœจ Features

๐ŸŽฏ Daily Word Learning

  • One word per day - Focus on quality over quantity
  • Level-based content - Beginner, Intermediate, and Advanced words
  • Multi-language support - Learn Spanish, English, and more!

๐ŸŒ Truly Global

  • 11 UI languages - English, Turkish, Spanish, German, French, Portuguese, Italian, Russian, Japanese, Korean, Chinese
  • Learn any language - Choose your native language and target language
  • Localized translations - Meanings shown in your native language

๐Ÿ—บ๏ธ Learning Journey

  • Visual roadmap - Track your daily progress
  • Streak system - Build consistency with day streaks
  • Milestones - Celebrate achievements at 7, 14, 30, 60, and 100 days

๐Ÿ’ฌ AI Practice Mode

  • Chat with AI tutor - Practice using the word in context
  • Gentle corrections - Learn from mistakes without frustration
  • Quick replies - Get examples, meanings, and pronunciation help

๐ŸŽจ Beautiful UX

  • Modern gradient design - Eye-catching purple/blue theme
  • Smooth animations - Delightful micro-interactions
  • Kawaii aesthetic - Friendly and approachable design

๐Ÿ“ฑ Screenshots

Onboarding Home Screen Journey Map
๐Ÿ‘‹ Welcome flow ๐Ÿ“š Daily word card ๐Ÿ—บ๏ธ Progress tracking
Select native language See word + meaning Visual day-by-day path
Choose target language Practice with AI Streak & milestones
Pick your level Tap to reveal meaning Motivational messages

๐Ÿš€ Installation

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Expo Go app on your phone

Quick Start

# Clone the repository
git clone https://github.com/samigulec/Bi-kelime.git

# Navigate to project
cd Bi-kelime/DailyIdiomApp

# Install dependencies
npm install

# Start the development server
npx expo start

Running on Device

  1. Install Expo Go from App Store / Play Store
  2. Scan the QR code from terminal
  3. App will load on your device!

๐Ÿ› ๏ธ Tech Stack

Technology Purpose
React Native Cross-platform mobile framework
Expo Development platform & tooling
TypeScript Type-safe JavaScript
AsyncStorage Local data persistence
Expo Linear Gradient Beautiful gradient backgrounds
Expo Haptics Tactile feedback
React Native Animated Smooth UI animations

๐Ÿ“ Project Structure

DailyIdiomApp/
โ”œโ”€โ”€ App.tsx                 # Main app entry & navigation
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ screens/
โ”‚   โ”‚   โ”œโ”€โ”€ OnboardingScreen.tsx   # 3-step welcome flow
โ”‚   โ”‚   โ”œโ”€โ”€ HomeScreen.tsx         # Daily word display
โ”‚   โ”‚   โ”œโ”€โ”€ ChatScreen.tsx         # AI practice chat
โ”‚   โ”‚   โ””โ”€โ”€ JourneyScreen.tsx      # Progress roadmap
โ”‚   โ”œโ”€โ”€ data/
โ”‚   โ”‚   โ””โ”€โ”€ content/
โ”‚   โ”‚       โ”œโ”€โ”€ en_content.json    # English words (A1-C2)
โ”‚   โ”‚       โ””โ”€โ”€ es_content.json    # Spanish words (A1-C2)
โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ”‚   โ”œโ”€โ”€ translations.ts        # UI translations (11 languages)
โ”‚   โ”‚   โ”œโ”€โ”€ contentLoader.ts       # Level-based content loading
โ”‚   โ”‚   โ””โ”€โ”€ storage.ts             # AsyncStorage helpers
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”‚   โ””โ”€โ”€ aiChat.ts              # AI tutor responses
โ”‚   โ””โ”€โ”€ types/
โ”‚       โ””โ”€โ”€ index.ts               # TypeScript definitions
โ””โ”€โ”€ assets/                        # App icons & images

๐ŸŽฎ How It Works

1๏ธโƒฃ Onboarding (First Launch)

Step 1: "I speak..." โ†’ Select your native language
Step 2: "I want to learn..." โ†’ Choose target language  
Step 3: "My level is..." โ†’ Pick Beginner/Intermediate/Advanced

2๏ธโƒฃ Daily Learning

  • Open the app each day
  • See your word of the day
  • Tap "Show Meaning" to reveal translation
  • Practice with AI to reinforce learning

3๏ธโƒฃ Track Progress

  • Tap the streak counter to see your journey
  • Complete daily lessons to unlock new days
  • Earn milestone badges as you progress

๐ŸŒ Supported Languages

As Native Language (UI)

๐Ÿ‡บ๐Ÿ‡ธ English โ€ข ๐Ÿ‡น๐Ÿ‡ท Tรผrkรงe โ€ข ๐Ÿ‡ช๐Ÿ‡ธ Espaรฑol โ€ข ๐Ÿ‡ฉ๐Ÿ‡ช Deutsch โ€ข ๐Ÿ‡ซ๐Ÿ‡ท Franรงais โ€ข ๐Ÿ‡ง๐Ÿ‡ท Portuguรชs โ€ข ๐Ÿ‡ฎ๐Ÿ‡น Italiano โ€ข ๐Ÿ‡ท๐Ÿ‡บ ะ ัƒััะบะธะน โ€ข ๐Ÿ‡ฏ๐Ÿ‡ต ๆ—ฅๆœฌ่ชž โ€ข ๐Ÿ‡ฐ๐Ÿ‡ท ํ•œ๊ตญ์–ด โ€ข ๐Ÿ‡จ๐Ÿ‡ณ ไธญๆ–‡

As Target Language (Learning)

๐Ÿ‡บ๐Ÿ‡ธ English โ€ข ๐Ÿ‡ช๐Ÿ‡ธ Spanish (more coming soon!)


๐Ÿ“Š Content Levels

Level Badge Description Example Words
๐ŸŒฑ Beginner A1 Basic vocabulary Hello, Thank you, Friend
๐Ÿ“š Intermediate B1 Everyday topics However, Develop, Despite
๐Ÿš€ Advanced C1 Complex expressions Nevertheless, Elucidate

๐Ÿค Contributing

Contributions are welcome! Here's how you can help:

  1. Add more words - Expand the content files
  2. Add languages - Create new xx_content.json files
  3. Improve translations - Enhance UI translations
  4. Fix bugs - Report or fix issues
  5. Suggest features - Open a feature request
# Fork the repo
# Create your feature branch
git checkout -b feature/AmazingFeature

# Commit your changes
git commit -m 'Add some AmazingFeature'

# Push to the branch
git push origin feature/AmazingFeature

# Open a Pull Request

๐Ÿ“œ License

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


๐Ÿ™ Acknowledgments

  • Inspired by language learning apps like Duolingo
  • Built with โค๏ธ using React Native & Expo
  • Icons and emojis from native system fonts

Made with ๐Ÿ’œ for language learners worldwide

โฌ† Back to top

About

One word / BI'kelime

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors