GitHub Embed repo is a flexible component that allows you to seamlessly embed GitHub repository information in your web applications. It provides an easy way to showcase your projects with style.
Check the demo at https://oct4pie.github.io/github-embed-repo
- Browsing through repositories
- Display detailed GitHub repository information including stars, forks, issues, and more
- Customizable themes
- Lazy loading for optimal performance
- Lightweight bundle size
- Support for both vanilla JavaScript and React applications
- Built with Chakra UI for consistent styling
github-embed-repo.mp4
You can install the GitHub Embed Repo package using npm or yarn:
# Using npm
npm install github-embed-repo
# Using yarn
yarn add github-embed-repo
Include the script in your HTML file and use it as follows:
<script src="https://cdn.jsdelivr.net/npm/github-embed-repo/dist/github_embed_repo.min.js"></script>
<script>
github_embed_repo.default('repo-details', 'Oct4Pie', 'github-embed-repo', {
showProfile: true,
showStats: true,
theme: 'dark',
statsToShow: ['stars', 'forks', 'watchers', 'issues', 'pull_requests', 'contributors'],
component: 'card'
});
</script>
Import the component and use it in your React application:
import React from 'react';
import GitRepo from 'github-embed-repo';
const MyComponent = () => (
<GitRepo
user="Oct4Pie"
repo="github-embed-repo"
options={{
component: 'card',
showProfile: true,
showStats: true,
theme: 'dark',
statsToShow: ['stars', 'forks', 'watchers', 'issues', 'pull_requests', 'contributors'],
}}
/>
);
export default MyComponent;
You can customize the component with these options:
const options = {
component: 'card'
showProfile: true,
showStats: true,
theme: 'dark',
statsToShow: ['stars', 'forks', 'watchers', 'issues', 'pull_requests', 'contributors'],
};
component
: 'card' for a compact view or 'repo' for a detailed view.showProfile
: Boolean to show or hide the repository owner's profile.showStats
: Boolean to show or hide repository statistics.theme
: 'light' or 'dark' to set the color scheme.statsToShow
: Array of statistics to display.
To set up the project for development:
- Clone the repository:
git clone https://github.com/Oct4Pie/github-embed-repo.git
- Install dependencies:
cd github-embed-repo # or github-embed-repo/demo/react-demo npm install
- Start the development server:
npm start
If you encounter any problems or have any questions, please open an issue on the GitHub repository.
This project is licensed under the MIT License - see the LICENSE file for details.