Podcaster

🎤 Escucha, descubre, disfruta: ¡Podcaster lo hace fácil! 🎧

This web application allows you to explore the top 100 iTunes podcasts in a simple and straightforward manner. Find your favorite shows and start listening to episodes in the blink of an eye. Simple and straightforward.

🚀 Installation

Clone the repository from GitHub using the following command:

git clone https://github.com/elmango80/podcaster.git
cd podcaster
npm install

💻 Usage

🚶 First steps

Once the installations are complete, you can start the application locally with the following command:

npm run start:dev

This will launch the application in your default web browser for development.

To build the application in production mode (minifying assets), use the following command:

npm run build:prod

If you want to build the application in development mode (without minifying assets), you can use the following command:

npm run build:dev

After the compilation, the optimized assets will be available in the output directory, ready to be deployed on the server.

If you wish to run unit and integration tests, you can execute the following command:

npm run test

🌴 Understanding Podcaster folder structure

podcaster/
│
├── 📁 src/                   # Main source code directory
│   ├── 📁 assets/            # Multimedia resources (images, audio)
│   ├── 📁 components/        # Reusable UI components
│   ├── 📁 context/           # Global state management
│   ├── 📁 hooks/             # Custom hooks
│   ├── 📁 pages/             # Main app pages/views
│   ├── 📁 routes/            # Route configuration
│   ├── 📁 service/           # Data management services
│   ├── 📁 types/             # Data types and definitions
│   ├── 📄 App.css            # Global styles
│   ├── 📄 App.tsx            # Main entry point (React)
│   └── ...
│
├── public/                   # Public resources directory
│   ├── 📄 favicon.svg        # Website icon (SVG)
│   └── ...
│
├── tests/                    # Unit and integration tests
│
├── 📄 .editorconfig          # Code style configuration
├── 📄 .eslintrc.js           # ESLint rules/config
├── 📄 .gitignore             # Git ignore list
├── 📄 .prettierrc.cjs        # Prettier code formatting config
├── 📄 index.html             # Main HTML page
├── 📄 jest.config.js         # Jest testing config
├── 📄 package.json           # Project dependencies/config
├── 📄 postcss.config.js      # PostCSS configuration for styles
├── 📄 tailwind.config.js     # Tailwind CSS configuration
├── 📄 tsconfig.json          # TypeScript configuration
└── 📄 vite.config.js         # Vite development bundler config

🤝 Contributing

If you want to implement a new feature/script, please, open an issue first

elmango80 / podcaster