owncast/web/README.md

43 lines
1.8 KiB
Markdown
Raw Normal View History

2020-10-01 00:38:39 +02:00
This is a [Next.js](https://nextjs.org/) project with [TypeScript](https://www.typescriptlang.org/), [Sass](https://sass-lang.com/) styling, using [Ant Design](https://ant.design/) UI components.
2020-09-30 23:59:20 +02:00
## Getting Started
2021-05-06 23:48:10 +02:00
**First**, run the development server:
2020-09-30 23:59:20 +02:00
```bash
npm run dev
# or
yarn dev
```
2021-05-06 23:48:10 +02:00
**Second**, make sure you're running an instance of Owncast on localhost:8080, as your copy of the admin will look to use that as the API.
2020-10-04 05:59:25 +02:00
In production this Admin instance would ideally live on the domain as your Owncast instance, for example: `myowncast-site.com/admin`. So open [http://localhost:3000/admin](http://localhost:3000/admin) with your browser to see the result.
2020-09-30 23:59:20 +02:00
2020-10-01 00:21:54 +02:00
You can start editing a page by modifying `pages/something.js`. The page auto-updates as you edit the file.
Add new pages by adding files to the `pages` directory and [routes](https://nextjs.org/docs/api-reference/next/router) will be available for this new page component.
Since this project hits API endpoints you should make requests in [`componentDidMount`](https://reactjs.org/docs/react-component.html#componentdidmount), and not in [`getStaticProps`](https://nextjs.org/docs/basic-features/data-fetching), since they're not static and we don't want to fetch them at build time, but instead at runtime.
2020-09-30 23:59:20 +02:00
2020-10-04 05:59:25 +02:00
A list of API end points can be found here:
2021-05-06 23:48:10 +02:00
https://owncast.online/api/development/
2020-10-04 05:59:25 +02:00
### Auth-ing for APIs
2021-05-06 23:48:10 +02:00
Auth: HTTP Basic
2020-10-04 05:59:25 +02:00
username: admin
2021-05-06 23:48:10 +02:00
pw: [your streamkey]
2020-10-04 05:59:25 +02:00
2020-09-30 23:59:20 +02:00
## Learn More
To learn more about Next.js, take a look at the following resources:
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
2020-10-04 05:59:25 +02:00