-
Notifications
You must be signed in to change notification settings - Fork 210
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Hporutiu readme updates to node.js stickies CSV app #183
Changes from 1 commit
2b55140
5b3ce52
5ef483f
db7c9e3
b06ac91
1104bc7
1c85c0e
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,95 @@ | ||
# Miro Example App | ||
|
||
<b>Use this template to contribute to Miro's App Examples!</b> | ||
|
||
This app shows how to use a certain Miro SDK or API functionality to accomplish a certain task. | ||
|
||
# 👨🏻💻 App Demo | ||
|
||
<b>Insert app demo here.</b> | ||
|
||
# 📒 Table of Contents | ||
|
||
- [Included Features](#features) | ||
- [Tools and Technologies](#tools) | ||
- [Prerequisites](#prerequisites) | ||
- [Associated Developer Tutorial](#tutorial) | ||
- [Run the app locally](#run) | ||
- [Folder Structure](#folder) | ||
- [Contributing](#contributing) | ||
- [License](#license) | ||
|
||
# ⚙️ Included Features <a name="features"></a> | ||
|
||
- [Miro Web SDK](https://developers.miro.com/docs/web-sdk-reference) | ||
> Insert SDK methods here which your project uses | ||
|
||
# 🛠️ Tools and Technologies <a name="tools"></a> | ||
|
||
> Insert tools and technologies here which your project uses and link to them. | ||
|
||
# ✅ Prerequisites <a name="prerequisites"></a> | ||
|
||
- You have a [Miro account](https://miro.com/signup/). | ||
- You're [signed in to Miro](https://miro.com/login/). | ||
- Your Miro account has a [Developer team](https://developers.miro.com/docs/create-a-developer-team). | ||
- Your development environment includes [Node.js 14.13](https://nodejs.org/en/download) or a later version. | ||
- All examples use `npm` as a package manager and `npx` as a package runner. | ||
|
||
> Add any other prerequisites here! | ||
|
||
# 🏃🏽♂️ Run the app locally <a name="run"></a> | ||
|
||
> <b>Add steps to run the app locally. Try to make them as similar as possible to other example apps for consistency.</b> | ||
|
||
1. Run `npm install` to install dependencies. | ||
2. Run `npm start` to start developing. \ | ||
Your URL should be similar to this example: | ||
``` | ||
http://localhost:3000 | ||
``` | ||
3. Open the [app manifest editor](https://developers.miro.com/docs/manually-create-an-app#step-2-configure-your-app-in-miro) by clicking **Edit in Manifest**. \ | ||
In the app manifest editor, configure the app as follows: | ||
|
||
- [`sdkUri`](https://developers.miro.com/docs/app-manifest#sdkuri): assign `http://localhost:3000` as a value for this property. \ | ||
It defines the entry point of the app, and it corresponds to the URL of the server that the app runs on. | ||
- [`scopes`](https://developers.miro.com/docs/app-manifest#scopes): add the permission scopes that users need to grant the app when they install it. \ | ||
To enable the app to read from and write to the board, add the following permissions: | ||
- `boards:read` | ||
- `boards:write` | ||
|
||
4. Go back to your app home page, and under the `Permissions` section, you will see a blue button that says `Install app and get OAuth token`. Click that button. Then click on `Add` as shown in the video below. <b>In the video we install a different app, but the process is the same regardless of the app.</b> | ||
|
||
> ⚠️ We recommend to install your app on a [developer team](https://developers.miro.com/docs/create-a-developer-team) while you are developing or testing apps.⚠️ | ||
|
||
https://github.com/miroapp/app-examples/assets/10428517/1e6862de-8617-46ef-b265-97ff1cbfe8bf | ||
|
||
5. Go to your developer team, and open your boards. <b>Refresh your browser</b>. | ||
6. Click on the plus icon from the bottom section of your left sidebar. If you hover over it, it will say `More apps`. | ||
7. Search for your app `Calendar` or whatever you chose to name it. Click on your app to use it, as shown in the video below. <b>In the video we search for a different app, but the process is the same regardless of the app.</b> | ||
|
||
https://github.com/horeaporutiu/app-examples-template/assets/10428517/b23d9c4c-e785-43f9-a72e-fa5d82c7b019 | ||
|
||
# 🗂️ Folder structure <a name="folder"></a> | ||
|
||
<b>Explain your folder structure so a developer can quickly understand the layout of your code.</b> | ||
|
||
``` | ||
. | ||
├── src | ||
│ └── styles | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. You can delete these lines since its too specific There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 80-84 There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Good idea, just removed. Thank you! |
||
│ └── style.css <-- CSS styles for the app. | ||
│ └── App.tsx <-- The main app. Contains structure for the sidebar when launched. | ||
│ main.tsx <-- Initializes app. | ||
│ useCalendar.ts <-- Functions to generate a calendar. | ||
├── app.html <-- The app itself. This is loaded on the board inside the 'appContainer'. | ||
└── index.html <-- The app entry point. This is the value you assign to 'sdkUri' in the app manifest file. | ||
``` | ||
|
||
# 🫱🏻🫲🏽 Contributing <a name="contributing"></a> | ||
|
||
If you want to contribute to this example, or any other Miro Open Source project, please review [Miro's contributing guide](https://github.com/miroapp/app-examples/blob/main/CONTRIBUTING.md). | ||
|
||
# 🪪 License <a name="license"></a> | ||
|
||
[MIT License](https://github.com/miroapp/app-examples/blob/main/LICENSE). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
can't we have a copy/paste example?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added one, lmk if it is what you were thinking? @mettin