Hello-Rails-React: "A Random Rails React Greeting App"
- Tech Stack 🛠️
- Key Features ✨
- Getting Started 🚀
- Setup 🔧
- Installation ⚙️
- Usage 🧰
- Tests ✔️
- Troubleshooting 🔩
- Authors 🖋️
- Future Features 🌟
- Contributing 🤝
- Support 🆘
- Acknowledgments 🙏
- License 📄
- Greetings: Randomly Select a greeting message to users.
- Ensure you have Ruby installed on your system. You can check your Ruby version in the terminal by running:
ruby -v
If Ruby is not installed, you can download and install it from the official Ruby website.
- Ensure you have Ruby on Rails (RoR) installed on your system. You can check your Rails version in the terminal by running:
rails -v
If Rails is not installed, you can install it using the following command:
gem install rails
- To get a local copy up and running, follow these steps. Choose the directory on your local machine where you want to copy project. For example:
cd /home/user/name-of-your-directory
Clone the project using one of the options.
Using SSH-key:
git clone git@github.com:cosmosha/hello-rails-react.git
Using HTTPS:
git clone https://github.com/cosmosha/hello-rails-react.git
You can also create the new directory just adding the name of it in the end of command. For example:
git clone https://github.com/cosmosha/hello-rails-react
To run this project locally, follow these steps:
-
Open your terminal or command prompt.
-
Navigate to the directory where you have cloned or downloaded the Ultimate Recipe Assistant repository.
-
Run the following command to install any required dependencies:
bundle install
-
Once the setup is complete, ensure you are still in the directory containing the Ultimate Recipe Assistant files.
-
To set up the database and seed initial data, run the following commands:
rails db:create
rails db:migrate
This will create the database and apply migrations.
If you want to populate the database you can run (this step is not required):
rails db:seed
- To precompile assets for production deployment, execute the following command:
rails assets:precompile
Precompiling assets is essential for improved performance and loading times in a production environment.
- To run the app in development mode, execute the following command:
rails server
- The app will be accessible at
http://localhost:3000in your web browser.
If you encounter any issues with the email verification process, please refer to the Devise documentation or seek assistance from the Devise community.
- If you have future features like GUI or interactive mode, follow the specific instructions provided for those features in the app's documentation.
If you encounter any issues related to missing assets or unexpected behavior after making changes, try the following steps:
- Delete the
tmpdirectory located in the root of your project:
rm -rf tmp/
This can help clear any cached data that might be causing issues.
- Delete the
public/assetsdirectory:
rm -rf public/assets/
This ensures that any previously precompiled assets are removed, and new ones will be generated during the next precompilation.
If you encounter any problems related to data or database inconsistencies, you can follow these steps to reset your database:
-
Ensure Server/Process Shutdown: Make sure that your Rails server or any related processes are not running. You should not have any active connections to the database.
-
Drop the Database:
rake db:drop
or
rails db:drop
- Recreate the Database how to
After dropping the database, you can recreate it from scratch. Run migrations to set up the schema.
If problems persist, you can refer to the official Ruby on Rails Guides for more troubleshooting tips and guidance.
To run the tests for the Ultimate Recipe Assistant requests and models, ensure you are in the directory containing the test files.
- Install RSpec:
Find your gemfile and add the RSpec gem in the development, test group:
group :development, :test do
gem 'rspec-rails'
end
- Then in your terminal run the command:
bundle install
- To set up RSpec in your app and create the Spec folder run:
rails generate rspec:install
- Run the tests for all the models using the following command:
rspec spec/models
- Alternatively, you could run tests for any specific suit using the following command (an example for Like model):
rspec spec/models/like_spec.rb
- All tests should pass without any errors or failures, ensuring that all models and their methods are functioning correctly.
🧑🦲 Cosmos Hagan
- GitHub: @Cosmosha
- Tests to verify the behavior of controller actions and responses.
If you'd like to contribute to this project, please follow these steps:
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Make your changes and commit them with descriptive commit messages.
- Push your changes to your forked repository.
- Submit a pull request to the main repository, explaining your changes in detail.
Please adhere to the coding conventions and guidelines specified in the project.
Feel free to check the issues page.
If you encounter any issues or have any questions or suggestions, please open an issue on the issue tracker. Furthermore, if you would like to get in touch with me, you can find our contact information in the Authors section.
I would like to thank the following individuals and projects for their contributions and inspiration:
Ruby official : Special thanks to Yukihiro Matsumoto, the creator of the Ruby programming language, for giving me this powerful and elegant tool to build amazing applications. I am also grateful to the Ruby Core Team and the passionate Ruby community for their continuous support and contributions.
Ruby on Rails : A big thank you to the creators, contributors, and maintainers of the Ruby on Rails framework. Your efforts have empowered countless developers to build powerful and scalable web applications.
This project is MIT licensed.