Rayous is a modern, lightweight, and flexible web application framework for building server-rendered web applications using TypeScript and JavaScript. With Rayous, you can quickly create web applications that embrace the power of server and client-side rendering, allowing you to deliver dynamic, interactive web experiences.
-
Flexible Routing: Rayous provides a powerful routing system inspired by popular frameworks like Next.js. Define routes using a simple file structure and use dynamic parameters, giving you full control over your application's URLs.
-
Component-Based: Rayous promotes a component-based architecture, making it easy to create reusable and modular components that you can combine to build complex user interfaces.
-
TypeScript and JavaScript Support: You can develop your Rayous applications using both TypeScript and JavaScript, providing flexibility to work with your preferred language.
-
Intuitive Configuration: A simple
rayous.jsonfile allows you to configure application metadata, such as the title, author, and more, making it easy to manage your application's metadata. -
Static Files: Rayous follows a convention where static files (e.g., images, styles, scripts) should be placed in the
static/directory located outside of theapp/folder. This separation helps maintain clarity and organization in your project.
To start building your web application with Rayous, follow these steps:
-
Create a new folder and do
npm init -y -
Install the required dependencies using npm or yarn:
npm install rayous
-
Configure your routes, components, and other application-specific files within the
app/directory. Make sure to includestatic/for static files andrayous.jsonfor generl information.npx rayous create
-
Create reusable components in the
app/components/directory and use them in your route handlers to build your web pages. -
Run your Rayous application:
npx rayous
-
Access your application in a web browser by navigating to
http://localhost:3000or the port specified in your configuration.
You can customize your Rayous application by editing the rayous.json configuration file. This file allows you to set the application's title, author, and other metadata that is important for SEO and presentation.
For any help, you can refer to the Rayous Docs or Rayous Github Wiki.
For example usage and additional resources, visit the Rayous GitHub repository. The repository includes code examples and detailed documentation to help you get started with Rayous.
- Rayous Todo App Demo: A to-do list application built with Rayous.
- Rayous DaisyUI Demo: A demo project showcasing Rayous with DaisyUI integration.
- Rayous Webpack Demo: A quote application that runs with webpack as a bundler instead of bun.
- Rayous DaisyUI Components: A component list and an example for Rayous DaisyUI Library
Contributions to Rayous are welcome! If you have ideas, suggestions, or bug fixes, feel free to open issues and create pull requests on this repository.
For any questions or support, please open an issue on this repository.
Happy coding with Rayous!