diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 0000000..c08b0ca --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,59 @@ +# Contributing to the Ionic Vue Conference Application + +Thank you for taking the time to contribute! :tada::+1: + +The following is a set of guidelines for contributing to the conference app. These are just guidelines, not rules, use your best judgment and feel free to propose changes to this document in a pull request. + +## Table of Contents +- [Reporting Issues](#reporting-issues) + - [Before Submitting an Issue](#before-submitting-an-issue) + - [Determining the Repository](#determining-the-repository) + - [Submitting the Issue](#submitting-the-issue) +- [Submitting a Pull Request](#submitting-a-pull-request) + - [Guidelines for Submitting](#guidelines-for-submitting) + - [Code Style](#code-style) + +## Reporting Issues + +Before submitting an issue, please go through [the list below](#before-submitting-an-issue) as you might find a solution to your issue. + +### Before Submitting an Issue + +* Make sure you get the latest version of the code and run through the [Getting Started](https://github.com/ionic-team/ionic-vue-conference-app#getting-started) steps to see if this resolves your issue. +* Check the [forum](https://forum.ionicframework.com) for similar questions and answers. +* Go through [all issues](https://github.com/ionic-team/ionic-vue-conference-app/issues?utf8=%E2%9C%93&q=is%3Aissue) on this repository to see if the issue has already been created. It could have been closed with a resolution, so check closed issues, too. +* Chat with us on [Discord](https://ionic.link/discord) to see if we can find a solution to the problem! +* [Determine which repository](#determining-the-repository) the problem should be reported in. + +### Determining the Repository + +There are several repositories being used for Ionic, which makes it difficult to determine which one to report an issue to. Don't worry if you aren't sure, we can always move it! + +* The [Ionic Framework repository](https://github.com/ionic-team/ionic-framework) is a repository for all things related to the Ionic Framework. If you are able to reproduce the issue in any of the Ionic starters (or an existing project), you'll want to submit the issue [here](https://github.com/ionic-team/ionic-framework/issues). +* The [Ionic CLI repository](https://github.com/ionic-team/ionic-cli) contains all of the code that allows you to run `ionic` commands from a terminal window. It is safe to put any issues [here](https://github.com/ionic-team/ionic-cli/issues) that relate to running an `ionic` command. +* **This repository** is a demo of the Ionic Framework. If you find an issue with this app that does not occur on [a new app](https://ionicframework.com/docs/intro/cli#start-an-app), please submit the issue [here](https://github.com/ionic-team/ionic-vue-conference-app/issues). + +### Submitting the Issue + +* **Use a clear and descriptive title** for the issue to identify the problem. This makes it easier for others to find. +* **Describe the exact steps to reproduce the problem** with as many details as needed. +* **Provide your configuration** by running `ionic info` in a terminal from *within* the project folder and pasting this information in the issue. + +## Submitting a Pull Request + +### Guidelines for Submitting + +When in doubt, keep your pull requests small. To give a PR the best chance of getting accepted, do not bundle more than one "feature" or bug fix per PR. Doing so makes it very hard to accept it if one of the fixes has issues. + +It's always best to create two smaller PRs than one big one. + +Talk to us before creating a PR that refactors the code or directory structure of the project. This project is constantly changing to reflect the latest version of Ionic Framework so sometimes it will be in the process of getting fixed. + +### Code Style + +Make sure to follow the existing code style as much as possible. + +* No underscores prefixing JS functions. +* Use flat Sass: + * **Don't** use [BEM conventions](https://css-tricks.com/bem-101/) + * Avoid nesting selectors. This is done to make it easier for users without Sass experience to understand and read. diff --git a/README.md b/README.md index 8aa8fb9..14a0ad4 100644 --- a/README.md +++ b/README.md @@ -1,62 +1,70 @@ -# Ionic Vue Conference Application +# Ionic Vue Conference App +[](https://ionicframework.com) +[](https://vuejs.org) +[](LICENSE) -This application is purely a kitchen-sink demo of the Ionic Framework and Vue. +This is a **kitchen-sink demo application** built with **Ionic Framework** and **Vue**. It showcases a wide range of Ionic components and features in the context of a fictional tech conference app. -**There is not an actual Ionic Conference at this time.** This project is just to show off Ionic components in a real-world application. +**Note**: There is no actual Ionic Conference. This project is purely for demonstration purposes. -## React and Angular versions +👉 [Try the Live Demo](https://ionic-vue-conference-app-git-main-ionic1.vercel.app/tutorial) -We've built versions of this Conference app in React and Angular for developers that would prefer to use one of those framework options: +## 🧱 Framework Variants -https://github.com/ionic-team/ionic-react-conference-app +This app is also available in other frameworks: -https://github.com/ionic-team/ionic-conference-app +- 🔗 [Ionic Angular Conference App](https://github.com/ionic-team/ionic-conference-app) +- 🔗 [Ionic React Conference App](https://github.com/ionic-team/ionic-react-conference-app) +- ✅ **You're viewing the Vue version** -## Table of Contents -- [Getting Started](#getting-started) -- [App Preview](#app-preview) +## ✨ Features -## Getting Started +- Browse conference schedule with filtering +- View speaker bios and session details +- User authentication and profile management +- Interactive maps for venue navigation +- Push notifications support +- Dark/Light mode toggling +- Cross-platform support: iOS, Android, and Web -* [Download the installer](https://nodejs.org/) for Node LTS. -* Install the ionic CLI globally: `npm install -g ionic` -* Clone this repository: `git clone https://github.com/ionic-team/ionic-vue-conference-app.git`. -* Run `npm install` from the project root. -* Run `ionic serve` in a terminal from the project root. -* Profit. :tada: +## ⚙️ Getting Started -## App Preview +### Prerequisites -### [Menu](https://github.com/ionic-team/ionic-vue-conference-app/blob/main/src/components/Menu.vue) +- Node.js (LTS version recommended) → [Download](https://nodejs.org/) +- npm (included with Node.js) +- Ionic CLI → Install globally: + ```bash + npm install -g @ionic/cli + ``` -| Material Design | iOS | -| -----------------| -----| -|  |  | +### Installation +1. Clone the repository: + ```bash + git clone https://github.com/ionic-team/ionic-vue-conference-app.git + ``` +2. Navigate into the project: + ```bash + cd ionic-vue-conference-app + ``` +3. Install dependencies: + ```bash + npm install + ``` +4. Start the dev server: + ```bash + ionic serve + ``` +5. Open your browser to: + ``` + http://localhost:8100 + ``` +## 🤝 Contributing -### [Schedule Page](https://github.com/ionic-team/ionic-vue-conference-app/blob/main/src/views/SessionList.vue) - -| Material Design | iOS | -| -----------------| -----| -|  |  | - -### [Speakers Page](https://github.com/ionic-team/ionic-vue-conference-app/blob/main/src/views/SpeakerList.vue) - -| Material Design | iOS | -| -----------------| -----| -|  |  | - -### [Speaker Detail Page](https://github.com/ionic-team/ionic-vue-conference-app/blob/main/src/views/SpeakerDetail.vue) - -| Material Design | iOS | -| -----------------| -----| -|  |  | - -### [About Page](https://github.com/ionic-team/ionic-vue-conference-app/blob/main/src/views/About.vue) - -| Material Design | iOS | -| -----------------| -----| -|  |  | +We welcome contributions! Please see our [Contributing Guide](.github/CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project. +## 📄 License +This project is licensed under the MIT [License](./LICENSE). diff --git a/index.html b/index.html index ac54776..d41dfe6 100644 --- a/index.html +++ b/index.html @@ -2,11 +2,10 @@
-- The Ionic Conference is a one-day conference on - {{ dateFormat(conferenceDate, "MMM dd, yyyy") }} - featuring talks from the Ionic team. It is focused on Ionic applications being built with Ionic Framework. This includes migrating apps to the latest version of the framework, Angular concepts, Webpack, Sass, and many other technologies used in Ionic 7. Tickets are completely sold out, and we’re expecting more than 1000 developers – making this the largest Ionic conference ever! + The Ionic Conference is a one-day event happening on + {{ dateFormat(conferenceDate, "MMM dd, yyyy") }}, + featuring talks from the Ionic team. The conference focuses on + building applications with Ionic Framework, including topics such + as app migration to the latest version, Vue best practices, Webpack, + Sass, and other technologies commonly used in the Ionic ecosystem. Tickets + are completely sold out, and we're expecting over 1,000 developers — + making this the largest Ionic conference to date!
{{ session.description }}
- {{ dateFormat(session.dateTimeStart, "h:mm a") }} — - {{ dateFormat(session.dateTimeEnd, "h:mm a") }}: + {{ session.timeStart }} — {{ session.timeEnd }}: {{ session.location }}
{{ speaker ? speaker.about : '' }}
+{{ speaker?.about || 'Loading biography...' }} Say hello on social media!
+ +{{ speaker.title }}
+{{ speaker.title }}
+