Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/delucis/astro-embed

Low-JavaScript embed components for Astro websites
https://github.com/delucis/astro-embed

astro oembed twitter vimeo youtube

Last synced: 7 days ago
JSON representation

Low-JavaScript embed components for Astro websites

Awesome Lists containing this project

README

        

# Astro Embed

Welcome! This project aims to collect easy-to-use and lightweight ways to embed common media into your [Astro](https://astro.build/) site.

## ๐Ÿ“š Documentation

Want to get started using some embed components?

Check out the [`astro-embed` documentation](https://astro-embed.netlify.app/)

## ๐Ÿš€ Project Structure

This project uses a monorepo structure with a separate workspace for each embed type. Youโ€™ll find a directory for each service in the [`/packages`](packages) directory.

The Astro site in the [`/demo`](demo) directory can be used to preview the various components and the files in [`/tests`](tests) are used to run automated testing on the components.

## ๐Ÿงž Commands

All commands are run from the root of the project, from a terminal:

| Command | Action |
| :------------ | :-------------------------------------------------------------- |
| `npm install` | Installs dependencies |
| `npm start` | Starts local dev server for the `demo` site at `localhost:3000` |
| `npm t` | Run the test suite |

## ๐Ÿงช Testing

You can run unit tests by running `npm t` in a terminal or run `npm start` to start a dev server for the demo project.

## โœจ Want to contribute?

This is an Astro Community project. That means YOU!

- ๐Ÿ›  Want to build a missing component? [We have a guide for that.](CONTRIBUTING.md)

- ๐Ÿ› Found a bug? Open a [new issue](https://github.com/delucis/astro-embed/issues/new/choose) to let us know.

- ๐Ÿ’ฌ Want to chat? Jump into [the Astro Discord server](https://astro.build/chat).