Skip to content

bdr0id/devvscape-code-humor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Developers Escape (Devvscape) πŸš€

Angular Ionic TypeScript License: MIT PRs Welcome Code Style

A mobile-first application providing code-related humor and entertainment for developers. Built with modern web technologies and following best practices in mobile development.

πŸ“₯ Download

Get it on Google Play

✨ Features

  • 🎭 Code Humor: Curated collection of programming jokes and memes
  • πŸ“± Mobile-First: Responsive design optimized for mobile devices
  • πŸ”” Push Notifications: Stay updated with new content
  • 🌐 In-App Browser: Seamless web browsing experience
  • πŸ’° AdMob Integration: Monetization through Google AdMob
  • πŸ”„ Offline Support: Service workers for offline functionality
  • 🌍 Multi-Language: Internationalization support
  • πŸ“² PWA Ready: Progressive Web App capabilities
  • πŸ” Authentication: Secure user authentication with Firebase
  • πŸ“Š Analytics: Built-in analytics and tracking
  • 🎨 Modern UI: Clean, intuitive user interface

πŸ› οΈ Technology Stack

Frontend

  • Angular 18 - Progressive web application framework
  • Ionic Framework - Mobile-first UI components
  • TypeScript - Type-safe JavaScript
  • RxJS - Reactive programming library
  • NgRx - State management with Redux pattern

Backend & Services

  • Firebase - Backend-as-a-Service
    • Firestore - NoSQL database
    • Authentication - User management
    • Storage - File storage
    • Analytics - User analytics
    • Messaging - Push notifications

Mobile & Native

  • Capacitor - Native functionality bridge
  • Android - Native Android support
  • PWA - Progressive Web App

Development Tools

  • ESLint - Code linting
  • Prettier - Code formatting
  • Jasmine/Karma - Testing framework
  • Transloco - Internationalization

πŸ“± Platform Support

  • βœ… Web Application - Modern browsers
  • βœ… Android Mobile App - Google Play Store
  • βœ… Progressive Web App - Installable web app

πŸš€ Quick Start

Prerequisites

  • Node.js (v18 or higher)
  • npm (v9 or higher)
  • Android Studio (for Android development)
  • Firebase Account

Installation

  1. Clone the repository

    git clone https://github.com/{your-username}/devvscape-code-humor.git
    cd devvscape-code-humor
  2. Install dependencies

    npm install
  3. Environment Setup

    Create src/environments/environment.ts:

    export const environment = {
      production: false,
      firebaseConfig: {
        apiKey: 'your-api-key',
        authDomain: 'your-auth-domain',
        projectId: 'your-project-id',
        storageBucket: 'your-storage-bucket',
        messagingSenderId: 'your-messaging-sender-id',
        appId: 'your-app-id',
      },
    };
  4. Run development server

    npm start
    # or
    ionic serve
  5. Build for production

    npm run build

Android Development

# Build the app
ionic capacitor build

# Sync web code to native project
npx cap sync

# Open in Android Studio
npx cap open android

πŸ—οΈ Project Structure

devvscape-code-humor/
β”œβ”€β”€ src/                          # Source files
β”‚   β”œβ”€β”€ app/                      # Application code
β”‚   β”‚   β”œβ”€β”€ core/                 # Core modules
β”‚   β”‚   β”‚   β”œβ”€β”€ services/         # Application services
β”‚   β”‚   β”‚   β”œβ”€β”€ store/            # NgRx state management
β”‚   β”‚   β”‚   β”œβ”€β”€ guards/           # Route guards
β”‚   β”‚   β”‚   └── models/           # Data models
β”‚   β”‚   β”œβ”€β”€ components/           # Reusable components
β”‚   β”‚   β”œβ”€β”€ tabs/                 # Tab-based navigation
β”‚   β”‚   └── shared/               # Shared modules
β”‚   β”œβ”€β”€ assets/                   # Static assets
β”‚   β”œβ”€β”€ environments/             # Environment configurations
β”‚   └── theme/                    # Global styles
β”œβ”€β”€ android/                      # Android native project
β”œβ”€β”€ www/                          # Web build output
β”œβ”€β”€ resources/                    # App resources (icons, splash)
β”œβ”€β”€ public/                       # Public assets
└── docs/                         # Documentation

πŸ§ͺ Testing

# Run unit tests
npm test

# Run tests with coverage
npm run test:coverage

# Run e2e tests
npm run e2e

πŸ“¦ Build & Deploy

Web Build

# Development build
npm run build

# Production build
npm run build:prod

Android Build

# Build for Android
ionic capacitor build android

# Build APK
ionic capacitor build android --prod

🀝 Contributing

We love your input! We want to make contributing to Devvscape as easy and transparent as possible, whether it's:

  • πŸ› Reporting a bug
  • πŸ’‘ Discussing the current state of the code
  • πŸ”§ Submitting a fix
  • ✨ Proposing new features
  • πŸ“– Becoming a maintainer

See our Contributing Guide for details.

πŸ“‹ Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ› Bug Reports

We use GitHub issues to track public bugs. Report a bug by opening a new issue.

πŸ“„ License

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

πŸ™ Acknowledgments

  • Ionic Team - For the amazing mobile framework
  • Angular Team - For the robust web framework
  • Firebase Team - For the powerful backend services
  • Our Contributors - For making this project better

πŸ“ž Support

πŸ“Š Project Status

GitHub last commit GitHub issues GitHub pull requests GitHub stars


Made with ❀️ by the Devvscape Team

This project is actively maintained. For any issues or feature requests, please open an issue in the repository.