StoryKing Flutter App with DeepSeek & ElevenLabs

API Keys Required

This application requires API keys from two services:

1. DeepSeek API Key (via OpenRouter)

To get your DeepSeek API key:

1. Visit OpenRouter and create an account
2. Navigate to your account settings and generate an API key
3. Replace YOUR_DEEPSEEK_API_KEY in lib/screens/home_screen.dart with your actual API key

2. ElevenLabs API Key

To get your ElevenLabs API key:

1. Visit ElevenLabs and create an account
2. Go to your profile settings → API Key
3. Generate a new API key
4. Replace YOUR_ELEVENLABS_API_KEY in lib/screens/main_screen.dart with your actual API key

API Keys Implementation Locations

• DeepSeek API Key: lib/screens/home_screen.dart
• ElevenLabs API Key: lib/screens/main_screen.dart

Adjusting Token Settings

You can increase the tokens used for story generation in: lib/services/story_service.dart (around line 176) Change: 'max_tokens': 300, to your preferred value

Project Setup Requirements

Prerequisites

• Flutter SDK (Latest stable version recommended)
• JDK 17 (Required for Android build)
• Android Studio or VS Code with Flutter/Dart plugins

Gradle Configuration

This project uses:

• Gradle 7.5 or higher
• Android Gradle Plugin 7.3.0 or compatible version

Getting Started

1. Clone the repository
2. Add your API keys as mentioned above
3. Run flutter pub get to install dependencies
4. Run flutter run to start the application on a connected device or emulator

If you encounter Gradle-related errors, ensure you're using JDK 17 by:

• Setting JAVA_HOME environment variable to point to JDK 17
• Checking Android Studio/IntelliJ settings to use JDK 17 for the project

Environment Setup

1. Copy .env.template to a new file named .env
2. Fill in your API keys in the .env file:

Firebase Configuration

Get your Firebase API keys from your Firebase Console:

1. Go to Project Settings
2. Under "Your apps", find the configuration for each platform
3. Copy the API keys for each platform into your .env file

OpenRouter (DeepSeek) API Key

1. Visit OpenRouter
2. Create an account
3. Navigate to your account settings
4. Generate an API key
5. Add it to your .env file as OPENROUTER_API_KEY

ElevenLabs API Key

1. Visit ElevenLabs
2. Create an account
3. Go to your profile settings → API Key
4. Generate a new API key
5. Add it to your .env file as ELEVENLABS_API_KEY

Internship Work Overview

During my internship, I focused on the following areas:

• Frontend UI/UX development
• API integration (Elevenlabs TTS, Deepseek Story Service)
• State management
• App architecture and component design

Project Directory Guide

This guide will help you understand the parts of the project I worked on.

Main App Structure

• lib/main.dart: The entry point of the application with theme management and app initialization.

UI Screens (lib/screens/)

These files contain the screens I developed:

• main_screen.dart: The main app interface with navigation. Contains the Elevenlabs TTS API integration.
• home_screen.dart: The landing screen with story generation UI. Contains Deepseek API integration.
• profile_screen.dart: User profile UI with settings management.
• settings_screen.dart: App settings with theme and text size controls.
• favorites_screen.dart: UI for saved favorite stories.
• splash_screen.dart: Initial loading screen with animations.
• about_screen.dart: App information display.
• contact_screen.dart: Contact UI.
• help_support_screen.dart: Help documentation UI.

API Services (lib/services/)

I implemented these service files for API integration:

• tts_service.dart: Text-to-speech functionality using Elevenlabs API.
• story_service.dart: Story generation using Deepseek API.
• storage_service.dart: Local data persistence.

Data Models (lib/models/)

These define the data structures I designed:

• story.dart: Story data model for managing generated content.
• user_model.dart: User data structure.

UI Components (lib/widgets/)

Reusable UI components I created:

• custom_drawer.dart: Side navigation drawer with animations.
• default_icon.dart: Icon components with consistent styling.

Key Features Implemented

1. Story Generation UI

   • Prompt input interface
   • Story display with animations
   • Loading states and error handling

2. Text-to-Speech Integration

   • Voice selection
   • Playback controls
   • Audio quality settings

3. Theme Management

   • Dark/light mode toggle
   • Persistent theme settings
   • Accessibility options (text scaling)

4. UI/UX Design

   • Custom animations
   • Responsive layouts
   • Intuitive navigation

Configuration

• pubspec.yaml: Project dependencies and assets configuration.
• flutter_launcher_icons.yaml: App icon specifications